diff --git a/.nojekyll b/.nojekyll new file mode 100644 index 00000000..e69de29b diff --git a/404.html b/404.html new file mode 100644 index 00000000..0210b992 --- /dev/null +++ b/404.html @@ -0,0 +1,659 @@ + + + + + + + + + + + + + + + + dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ +
+
+ +
+ + + + +
+ + +
+ +
+ + + + + + +
+
+ + + +
+
+
+ + + + +
+
+
+ + + +
+
+
+ + + +
+
+
+ + + +
+
+ +

404 - Not found

+ +
+
+ + +
+ +
+ + + + +
+
+
+
+ + + + + + + + + \ No newline at end of file diff --git a/assets/images/favicon.png b/assets/images/favicon.png new file mode 100644 index 00000000..1cf13b9f Binary files /dev/null and b/assets/images/favicon.png differ diff --git a/assets/javascripts/bundle.078830c0.min.js b/assets/javascripts/bundle.078830c0.min.js new file mode 100644 index 00000000..af96b246 --- /dev/null +++ b/assets/javascripts/bundle.078830c0.min.js @@ -0,0 +1,29 @@ +"use strict";(()=>{var aa=Object.create;var wr=Object.defineProperty;var sa=Object.getOwnPropertyDescriptor;var ca=Object.getOwnPropertyNames,kt=Object.getOwnPropertySymbols,fa=Object.getPrototypeOf,Er=Object.prototype.hasOwnProperty,fn=Object.prototype.propertyIsEnumerable;var cn=(e,t,r)=>t in e?wr(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r,H=(e,t)=>{for(var r in t||(t={}))Er.call(t,r)&&cn(e,r,t[r]);if(kt)for(var r of kt(t))fn.call(t,r)&&cn(e,r,t[r]);return e};var un=(e,t)=>{var r={};for(var n in e)Er.call(e,n)&&t.indexOf(n)<0&&(r[n]=e[n]);if(e!=null&&kt)for(var n of kt(e))t.indexOf(n)<0&&fn.call(e,n)&&(r[n]=e[n]);return r};var yt=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports);var ua=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of ca(t))!Er.call(e,o)&&o!==r&&wr(e,o,{get:()=>t[o],enumerable:!(n=sa(t,o))||n.enumerable});return e};var Ye=(e,t,r)=>(r=e!=null?aa(fa(e)):{},ua(t||!e||!e.__esModule?wr(r,"default",{value:e,enumerable:!0}):r,e));var ln=yt((Sr,pn)=>{(function(e,t){typeof Sr=="object"&&typeof pn!="undefined"?t():typeof define=="function"&&define.amd?define(t):t()})(Sr,function(){"use strict";function e(r){var n=!0,o=!1,i=null,s={text:!0,search:!0,url:!0,tel:!0,email:!0,password:!0,number:!0,date:!0,month:!0,week:!0,time:!0,datetime:!0,"datetime-local":!0};function a(_){return!!(_&&_!==document&&_.nodeName!=="HTML"&&_.nodeName!=="BODY"&&"classList"in _&&"contains"in _.classList)}function c(_){var We=_.type,Fe=_.tagName;return!!(Fe==="INPUT"&&s[We]&&!_.readOnly||Fe==="TEXTAREA"&&!_.readOnly||_.isContentEditable)}function f(_){_.classList.contains("focus-visible")||(_.classList.add("focus-visible"),_.setAttribute("data-focus-visible-added",""))}function u(_){!_.hasAttribute("data-focus-visible-added")||(_.classList.remove("focus-visible"),_.removeAttribute("data-focus-visible-added"))}function p(_){_.metaKey||_.altKey||_.ctrlKey||(a(r.activeElement)&&f(r.activeElement),n=!0)}function l(_){n=!1}function d(_){!a(_.target)||(n||c(_.target))&&f(_.target)}function h(_){!a(_.target)||(_.target.classList.contains("focus-visible")||_.target.hasAttribute("data-focus-visible-added"))&&(o=!0,window.clearTimeout(i),i=window.setTimeout(function(){o=!1},100),u(_.target))}function b(_){document.visibilityState==="hidden"&&(o&&(n=!0),U())}function U(){document.addEventListener("mousemove",W),document.addEventListener("mousedown",W),document.addEventListener("mouseup",W),document.addEventListener("pointermove",W),document.addEventListener("pointerdown",W),document.addEventListener("pointerup",W),document.addEventListener("touchmove",W),document.addEventListener("touchstart",W),document.addEventListener("touchend",W)}function G(){document.removeEventListener("mousemove",W),document.removeEventListener("mousedown",W),document.removeEventListener("mouseup",W),document.removeEventListener("pointermove",W),document.removeEventListener("pointerdown",W),document.removeEventListener("pointerup",W),document.removeEventListener("touchmove",W),document.removeEventListener("touchstart",W),document.removeEventListener("touchend",W)}function W(_){_.target.nodeName&&_.target.nodeName.toLowerCase()==="html"||(n=!1,G())}document.addEventListener("keydown",p,!0),document.addEventListener("mousedown",l,!0),document.addEventListener("pointerdown",l,!0),document.addEventListener("touchstart",l,!0),document.addEventListener("visibilitychange",b,!0),U(),r.addEventListener("focus",d,!0),r.addEventListener("blur",h,!0),r.nodeType===Node.DOCUMENT_FRAGMENT_NODE&&r.host?r.host.setAttribute("data-js-focus-visible",""):r.nodeType===Node.DOCUMENT_NODE&&(document.documentElement.classList.add("js-focus-visible"),document.documentElement.setAttribute("data-js-focus-visible",""))}if(typeof window!="undefined"&&typeof document!="undefined"){window.applyFocusVisiblePolyfill=e;var t;try{t=new CustomEvent("focus-visible-polyfill-ready")}catch(r){t=document.createEvent("CustomEvent"),t.initCustomEvent("focus-visible-polyfill-ready",!1,!1,{})}window.dispatchEvent(t)}typeof document!="undefined"&&e(document)})});var mn=yt(Or=>{(function(e){var t=function(){try{return!!Symbol.iterator}catch(f){return!1}},r=t(),n=function(f){var u={next:function(){var p=f.shift();return{done:p===void 0,value:p}}};return r&&(u[Symbol.iterator]=function(){return u}),u},o=function(f){return encodeURIComponent(f).replace(/%20/g,"+")},i=function(f){return decodeURIComponent(String(f).replace(/\+/g," "))},s=function(){var f=function(p){Object.defineProperty(this,"_entries",{writable:!0,value:{}});var l=typeof p;if(l!=="undefined")if(l==="string")p!==""&&this._fromString(p);else if(p instanceof f){var d=this;p.forEach(function(G,W){d.append(W,G)})}else if(p!==null&&l==="object")if(Object.prototype.toString.call(p)==="[object Array]")for(var h=0;hd[0]?1:0}),f._entries&&(f._entries={});for(var p=0;p1?i(d[1]):"")}})})(typeof global!="undefined"?global:typeof window!="undefined"?window:typeof self!="undefined"?self:Or);(function(e){var t=function(){try{var o=new e.URL("b","http://a");return o.pathname="c d",o.href==="http://a/c%20d"&&o.searchParams}catch(i){return!1}},r=function(){var o=e.URL,i=function(c,f){typeof c!="string"&&(c=String(c)),f&&typeof f!="string"&&(f=String(f));var u=document,p;if(f&&(e.location===void 0||f!==e.location.href)){f=f.toLowerCase(),u=document.implementation.createHTMLDocument(""),p=u.createElement("base"),p.href=f,u.head.appendChild(p);try{if(p.href.indexOf(f)!==0)throw new Error(p.href)}catch(_){throw new Error("URL unable to set base "+f+" due to "+_)}}var l=u.createElement("a");l.href=c,p&&(u.body.appendChild(l),l.href=l.href);var d=u.createElement("input");if(d.type="url",d.value=c,l.protocol===":"||!/:/.test(l.href)||!d.checkValidity()&&!f)throw new TypeError("Invalid URL");Object.defineProperty(this,"_anchorElement",{value:l});var h=new e.URLSearchParams(this.search),b=!0,U=!0,G=this;["append","delete","set"].forEach(function(_){var We=h[_];h[_]=function(){We.apply(h,arguments),b&&(U=!1,G.search=h.toString(),U=!0)}}),Object.defineProperty(this,"searchParams",{value:h,enumerable:!0});var W=void 0;Object.defineProperty(this,"_updateSearchParams",{enumerable:!1,configurable:!1,writable:!1,value:function(){this.search!==W&&(W=this.search,U&&(b=!1,this.searchParams._fromString(this.search),b=!0))}})},s=i.prototype,a=function(c){Object.defineProperty(s,c,{get:function(){return this._anchorElement[c]},set:function(f){this._anchorElement[c]=f},enumerable:!0})};["hash","host","hostname","port","protocol"].forEach(function(c){a(c)}),Object.defineProperty(s,"search",{get:function(){return this._anchorElement.search},set:function(c){this._anchorElement.search=c,this._updateSearchParams()},enumerable:!0}),Object.defineProperties(s,{toString:{get:function(){var c=this;return function(){return c.href}}},href:{get:function(){return this._anchorElement.href.replace(/\?$/,"")},set:function(c){this._anchorElement.href=c,this._updateSearchParams()},enumerable:!0},pathname:{get:function(){return this._anchorElement.pathname.replace(/(^\/?)/,"/")},set:function(c){this._anchorElement.pathname=c},enumerable:!0},origin:{get:function(){var c={"http:":80,"https:":443,"ftp:":21}[this._anchorElement.protocol],f=this._anchorElement.port!=c&&this._anchorElement.port!=="";return this._anchorElement.protocol+"//"+this._anchorElement.hostname+(f?":"+this._anchorElement.port:"")},enumerable:!0},password:{get:function(){return""},set:function(c){},enumerable:!0},username:{get:function(){return""},set:function(c){},enumerable:!0}}),i.createObjectURL=function(c){return o.createObjectURL.apply(o,arguments)},i.revokeObjectURL=function(c){return o.revokeObjectURL.apply(o,arguments)},e.URL=i};if(t()||r(),e.location!==void 0&&!("origin"in e.location)){var n=function(){return e.location.protocol+"//"+e.location.hostname+(e.location.port?":"+e.location.port:"")};try{Object.defineProperty(e.location,"origin",{get:n,enumerable:!0})}catch(o){setInterval(function(){e.location.origin=n()},100)}}})(typeof global!="undefined"?global:typeof window!="undefined"?window:typeof self!="undefined"?self:Or)});var Pn=yt((Ks,$t)=>{/*! ***************************************************************************** +Copyright (c) Microsoft Corporation. + +Permission to use, copy, modify, and/or distribute this software for any +purpose with or without fee is hereby granted. + +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY +AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, +INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR +OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR +PERFORMANCE OF THIS SOFTWARE. +***************************************************************************** */var dn,hn,bn,vn,gn,yn,xn,wn,En,Ht,_r,Sn,On,_n,rt,Tn,Mn,Ln,An,Cn,Rn,kn,Hn,Pt;(function(e){var t=typeof global=="object"?global:typeof self=="object"?self:typeof this=="object"?this:{};typeof define=="function"&&define.amd?define("tslib",["exports"],function(n){e(r(t,r(n)))}):typeof $t=="object"&&typeof $t.exports=="object"?e(r(t,r($t.exports))):e(r(t));function r(n,o){return n!==t&&(typeof Object.create=="function"?Object.defineProperty(n,"__esModule",{value:!0}):n.__esModule=!0),function(i,s){return n[i]=o?o(i,s):s}}})(function(e){var t=Object.setPrototypeOf||{__proto__:[]}instanceof Array&&function(n,o){n.__proto__=o}||function(n,o){for(var i in o)Object.prototype.hasOwnProperty.call(o,i)&&(n[i]=o[i])};dn=function(n,o){if(typeof o!="function"&&o!==null)throw new TypeError("Class extends value "+String(o)+" is not a constructor or null");t(n,o);function i(){this.constructor=n}n.prototype=o===null?Object.create(o):(i.prototype=o.prototype,new i)},hn=Object.assign||function(n){for(var o,i=1,s=arguments.length;i=0;u--)(f=n[u])&&(c=(a<3?f(c):a>3?f(o,i,c):f(o,i))||c);return a>3&&c&&Object.defineProperty(o,i,c),c},gn=function(n,o){return function(i,s){o(i,s,n)}},yn=function(n,o){if(typeof Reflect=="object"&&typeof Reflect.metadata=="function")return Reflect.metadata(n,o)},xn=function(n,o,i,s){function a(c){return c instanceof i?c:new i(function(f){f(c)})}return new(i||(i=Promise))(function(c,f){function u(d){try{l(s.next(d))}catch(h){f(h)}}function p(d){try{l(s.throw(d))}catch(h){f(h)}}function l(d){d.done?c(d.value):a(d.value).then(u,p)}l((s=s.apply(n,o||[])).next())})},wn=function(n,o){var i={label:0,sent:function(){if(c[0]&1)throw c[1];return c[1]},trys:[],ops:[]},s,a,c,f;return f={next:u(0),throw:u(1),return:u(2)},typeof Symbol=="function"&&(f[Symbol.iterator]=function(){return this}),f;function u(l){return function(d){return p([l,d])}}function p(l){if(s)throw new TypeError("Generator is already executing.");for(;i;)try{if(s=1,a&&(c=l[0]&2?a.return:l[0]?a.throw||((c=a.return)&&c.call(a),0):a.next)&&!(c=c.call(a,l[1])).done)return c;switch(a=0,c&&(l=[l[0]&2,c.value]),l[0]){case 0:case 1:c=l;break;case 4:return i.label++,{value:l[1],done:!1};case 5:i.label++,a=l[1],l=[0];continue;case 7:l=i.ops.pop(),i.trys.pop();continue;default:if(c=i.trys,!(c=c.length>0&&c[c.length-1])&&(l[0]===6||l[0]===2)){i=0;continue}if(l[0]===3&&(!c||l[1]>c[0]&&l[1]=n.length&&(n=void 0),{value:n&&n[s++],done:!n}}};throw new TypeError(o?"Object is not iterable.":"Symbol.iterator is not defined.")},_r=function(n,o){var i=typeof Symbol=="function"&&n[Symbol.iterator];if(!i)return n;var s=i.call(n),a,c=[],f;try{for(;(o===void 0||o-- >0)&&!(a=s.next()).done;)c.push(a.value)}catch(u){f={error:u}}finally{try{a&&!a.done&&(i=s.return)&&i.call(s)}finally{if(f)throw f.error}}return c},Sn=function(){for(var n=[],o=0;o1||u(b,U)})})}function u(b,U){try{p(s[b](U))}catch(G){h(c[0][3],G)}}function p(b){b.value instanceof rt?Promise.resolve(b.value.v).then(l,d):h(c[0][2],b)}function l(b){u("next",b)}function d(b){u("throw",b)}function h(b,U){b(U),c.shift(),c.length&&u(c[0][0],c[0][1])}},Mn=function(n){var o,i;return o={},s("next"),s("throw",function(a){throw a}),s("return"),o[Symbol.iterator]=function(){return this},o;function s(a,c){o[a]=n[a]?function(f){return(i=!i)?{value:rt(n[a](f)),done:a==="return"}:c?c(f):f}:c}},Ln=function(n){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var o=n[Symbol.asyncIterator],i;return o?o.call(n):(n=typeof Ht=="function"?Ht(n):n[Symbol.iterator](),i={},s("next"),s("throw"),s("return"),i[Symbol.asyncIterator]=function(){return this},i);function s(c){i[c]=n[c]&&function(f){return new Promise(function(u,p){f=n[c](f),a(u,p,f.done,f.value)})}}function a(c,f,u,p){Promise.resolve(p).then(function(l){c({value:l,done:u})},f)}},An=function(n,o){return Object.defineProperty?Object.defineProperty(n,"raw",{value:o}):n.raw=o,n};var r=Object.create?function(n,o){Object.defineProperty(n,"default",{enumerable:!0,value:o})}:function(n,o){n.default=o};Cn=function(n){if(n&&n.__esModule)return n;var o={};if(n!=null)for(var i in n)i!=="default"&&Object.prototype.hasOwnProperty.call(n,i)&&Pt(o,n,i);return r(o,n),o},Rn=function(n){return n&&n.__esModule?n:{default:n}},kn=function(n,o,i,s){if(i==="a"&&!s)throw new TypeError("Private accessor was defined without a getter");if(typeof o=="function"?n!==o||!s:!o.has(n))throw new TypeError("Cannot read private member from an object whose class did not declare it");return i==="m"?s:i==="a"?s.call(n):s?s.value:o.get(n)},Hn=function(n,o,i,s,a){if(s==="m")throw new TypeError("Private method is not writable");if(s==="a"&&!a)throw new TypeError("Private accessor was defined without a setter");if(typeof o=="function"?n!==o||!a:!o.has(n))throw new TypeError("Cannot write private member to an object whose class did not declare it");return s==="a"?a.call(n,i):a?a.value=i:o.set(n,i),i},e("__extends",dn),e("__assign",hn),e("__rest",bn),e("__decorate",vn),e("__param",gn),e("__metadata",yn),e("__awaiter",xn),e("__generator",wn),e("__exportStar",En),e("__createBinding",Pt),e("__values",Ht),e("__read",_r),e("__spread",Sn),e("__spreadArrays",On),e("__spreadArray",_n),e("__await",rt),e("__asyncGenerator",Tn),e("__asyncDelegator",Mn),e("__asyncValues",Ln),e("__makeTemplateObject",An),e("__importStar",Cn),e("__importDefault",Rn),e("__classPrivateFieldGet",kn),e("__classPrivateFieldSet",Hn)})});var Br=yt((At,Yr)=>{/*! + * clipboard.js v2.0.11 + * https://clipboardjs.com/ + * + * Licensed MIT © Zeno Rocha + */(function(t,r){typeof At=="object"&&typeof Yr=="object"?Yr.exports=r():typeof define=="function"&&define.amd?define([],r):typeof At=="object"?At.ClipboardJS=r():t.ClipboardJS=r()})(At,function(){return function(){var e={686:function(n,o,i){"use strict";i.d(o,{default:function(){return ia}});var s=i(279),a=i.n(s),c=i(370),f=i.n(c),u=i(817),p=i.n(u);function l(j){try{return document.execCommand(j)}catch(T){return!1}}var d=function(T){var O=p()(T);return l("cut"),O},h=d;function b(j){var T=document.documentElement.getAttribute("dir")==="rtl",O=document.createElement("textarea");O.style.fontSize="12pt",O.style.border="0",O.style.padding="0",O.style.margin="0",O.style.position="absolute",O.style[T?"right":"left"]="-9999px";var k=window.pageYOffset||document.documentElement.scrollTop;return O.style.top="".concat(k,"px"),O.setAttribute("readonly",""),O.value=j,O}var U=function(T,O){var k=b(T);O.container.appendChild(k);var $=p()(k);return l("copy"),k.remove(),$},G=function(T){var O=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body},k="";return typeof T=="string"?k=U(T,O):T instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(T==null?void 0:T.type)?k=U(T.value,O):(k=p()(T),l("copy")),k},W=G;function _(j){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?_=function(O){return typeof O}:_=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},_(j)}var We=function(){var T=arguments.length>0&&arguments[0]!==void 0?arguments[0]:{},O=T.action,k=O===void 0?"copy":O,$=T.container,q=T.target,Te=T.text;if(k!=="copy"&&k!=="cut")throw new Error('Invalid "action" value, use either "copy" or "cut"');if(q!==void 0)if(q&&_(q)==="object"&&q.nodeType===1){if(k==="copy"&&q.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if(k==="cut"&&(q.hasAttribute("readonly")||q.hasAttribute("disabled")))throw new Error(`Invalid "target" attribute. You can't cut text from elements with "readonly" or "disabled" attributes`)}else throw new Error('Invalid "target" value, use a valid Element');if(Te)return W(Te,{container:$});if(q)return k==="cut"?h(q):W(q,{container:$})},Fe=We;function Pe(j){return typeof Symbol=="function"&&typeof Symbol.iterator=="symbol"?Pe=function(O){return typeof O}:Pe=function(O){return O&&typeof Symbol=="function"&&O.constructor===Symbol&&O!==Symbol.prototype?"symbol":typeof O},Pe(j)}function Ji(j,T){if(!(j instanceof T))throw new TypeError("Cannot call a class as a function")}function sn(j,T){for(var O=0;O0&&arguments[0]!==void 0?arguments[0]:{};this.action=typeof $.action=="function"?$.action:this.defaultAction,this.target=typeof $.target=="function"?$.target:this.defaultTarget,this.text=typeof $.text=="function"?$.text:this.defaultText,this.container=Pe($.container)==="object"?$.container:document.body}},{key:"listenClick",value:function($){var q=this;this.listener=f()($,"click",function(Te){return q.onClick(Te)})}},{key:"onClick",value:function($){var q=$.delegateTarget||$.currentTarget,Te=this.action(q)||"copy",Rt=Fe({action:Te,container:this.container,target:this.target(q),text:this.text(q)});this.emit(Rt?"success":"error",{action:Te,text:Rt,trigger:q,clearSelection:function(){q&&q.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function($){return xr("action",$)}},{key:"defaultTarget",value:function($){var q=xr("target",$);if(q)return document.querySelector(q)}},{key:"defaultText",value:function($){return xr("text",$)}},{key:"destroy",value:function(){this.listener.destroy()}}],[{key:"copy",value:function($){var q=arguments.length>1&&arguments[1]!==void 0?arguments[1]:{container:document.body};return W($,q)}},{key:"cut",value:function($){return h($)}},{key:"isSupported",value:function(){var $=arguments.length>0&&arguments[0]!==void 0?arguments[0]:["copy","cut"],q=typeof $=="string"?[$]:$,Te=!!document.queryCommandSupported;return q.forEach(function(Rt){Te=Te&&!!document.queryCommandSupported(Rt)}),Te}}]),O}(a()),ia=oa},828:function(n){var o=9;if(typeof Element!="undefined"&&!Element.prototype.matches){var i=Element.prototype;i.matches=i.matchesSelector||i.mozMatchesSelector||i.msMatchesSelector||i.oMatchesSelector||i.webkitMatchesSelector}function s(a,c){for(;a&&a.nodeType!==o;){if(typeof a.matches=="function"&&a.matches(c))return a;a=a.parentNode}}n.exports=s},438:function(n,o,i){var s=i(828);function a(u,p,l,d,h){var b=f.apply(this,arguments);return u.addEventListener(l,b,h),{destroy:function(){u.removeEventListener(l,b,h)}}}function c(u,p,l,d,h){return typeof u.addEventListener=="function"?a.apply(null,arguments):typeof l=="function"?a.bind(null,document).apply(null,arguments):(typeof u=="string"&&(u=document.querySelectorAll(u)),Array.prototype.map.call(u,function(b){return a(b,p,l,d,h)}))}function f(u,p,l,d){return function(h){h.delegateTarget=s(h.target,p),h.delegateTarget&&d.call(u,h)}}n.exports=c},879:function(n,o){o.node=function(i){return i!==void 0&&i instanceof HTMLElement&&i.nodeType===1},o.nodeList=function(i){var s=Object.prototype.toString.call(i);return i!==void 0&&(s==="[object NodeList]"||s==="[object HTMLCollection]")&&"length"in i&&(i.length===0||o.node(i[0]))},o.string=function(i){return typeof i=="string"||i instanceof String},o.fn=function(i){var s=Object.prototype.toString.call(i);return s==="[object Function]"}},370:function(n,o,i){var s=i(879),a=i(438);function c(l,d,h){if(!l&&!d&&!h)throw new Error("Missing required arguments");if(!s.string(d))throw new TypeError("Second argument must be a String");if(!s.fn(h))throw new TypeError("Third argument must be a Function");if(s.node(l))return f(l,d,h);if(s.nodeList(l))return u(l,d,h);if(s.string(l))return p(l,d,h);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList")}function f(l,d,h){return l.addEventListener(d,h),{destroy:function(){l.removeEventListener(d,h)}}}function u(l,d,h){return Array.prototype.forEach.call(l,function(b){b.addEventListener(d,h)}),{destroy:function(){Array.prototype.forEach.call(l,function(b){b.removeEventListener(d,h)})}}}function p(l,d,h){return a(document.body,l,d,h)}n.exports=c},817:function(n){function o(i){var s;if(i.nodeName==="SELECT")i.focus(),s=i.value;else if(i.nodeName==="INPUT"||i.nodeName==="TEXTAREA"){var a=i.hasAttribute("readonly");a||i.setAttribute("readonly",""),i.select(),i.setSelectionRange(0,i.value.length),a||i.removeAttribute("readonly"),s=i.value}else{i.hasAttribute("contenteditable")&&i.focus();var c=window.getSelection(),f=document.createRange();f.selectNodeContents(i),c.removeAllRanges(),c.addRange(f),s=c.toString()}return s}n.exports=o},279:function(n){function o(){}o.prototype={on:function(i,s,a){var c=this.e||(this.e={});return(c[i]||(c[i]=[])).push({fn:s,ctx:a}),this},once:function(i,s,a){var c=this;function f(){c.off(i,f),s.apply(a,arguments)}return f._=s,this.on(i,f,a)},emit:function(i){var s=[].slice.call(arguments,1),a=((this.e||(this.e={}))[i]||[]).slice(),c=0,f=a.length;for(c;c{"use strict";/*! + * escape-html + * Copyright(c) 2012-2013 TJ Holowaychuk + * Copyright(c) 2015 Andreas Lubbe + * Copyright(c) 2015 Tiancheng "Timothy" Gu + * MIT Licensed + */var Ms=/["'&<>]/;Si.exports=Ls;function Ls(e){var t=""+e,r=Ms.exec(t);if(!r)return t;var n,o="",i=0,s=0;for(i=r.index;i0},enumerable:!1,configurable:!0}),t.prototype._trySubscribe=function(r){return this._throwIfClosed(),e.prototype._trySubscribe.call(this,r)},t.prototype._subscribe=function(r){return this._throwIfClosed(),this._checkFinalizedStatuses(r),this._innerSubscribe(r)},t.prototype._innerSubscribe=function(r){var n=this,o=this,i=o.hasError,s=o.isStopped,a=o.observers;return i||s?Tr:(this.currentObservers=null,a.push(r),new $e(function(){n.currentObservers=null,Ue(a,r)}))},t.prototype._checkFinalizedStatuses=function(r){var n=this,o=n.hasError,i=n.thrownError,s=n.isStopped;o?r.error(i):s&&r.complete()},t.prototype.asObservable=function(){var r=new F;return r.source=this,r},t.create=function(r,n){return new Qn(r,n)},t}(F);var Qn=function(e){ne(t,e);function t(r,n){var o=e.call(this)||this;return o.destination=r,o.source=n,o}return t.prototype.next=function(r){var n,o;(o=(n=this.destination)===null||n===void 0?void 0:n.next)===null||o===void 0||o.call(n,r)},t.prototype.error=function(r){var n,o;(o=(n=this.destination)===null||n===void 0?void 0:n.error)===null||o===void 0||o.call(n,r)},t.prototype.complete=function(){var r,n;(n=(r=this.destination)===null||r===void 0?void 0:r.complete)===null||n===void 0||n.call(r)},t.prototype._subscribe=function(r){var n,o;return(o=(n=this.source)===null||n===void 0?void 0:n.subscribe(r))!==null&&o!==void 0?o:Tr},t}(E);var wt={now:function(){return(wt.delegate||Date).now()},delegate:void 0};var Et=function(e){ne(t,e);function t(r,n,o){r===void 0&&(r=1/0),n===void 0&&(n=1/0),o===void 0&&(o=wt);var i=e.call(this)||this;return i._bufferSize=r,i._windowTime=n,i._timestampProvider=o,i._buffer=[],i._infiniteTimeWindow=!0,i._infiniteTimeWindow=n===1/0,i._bufferSize=Math.max(1,r),i._windowTime=Math.max(1,n),i}return t.prototype.next=function(r){var n=this,o=n.isStopped,i=n._buffer,s=n._infiniteTimeWindow,a=n._timestampProvider,c=n._windowTime;o||(i.push(r),!s&&i.push(a.now()+c)),this._trimBuffer(),e.prototype.next.call(this,r)},t.prototype._subscribe=function(r){this._throwIfClosed(),this._trimBuffer();for(var n=this._innerSubscribe(r),o=this,i=o._infiniteTimeWindow,s=o._buffer,a=s.slice(),c=0;c0?e.prototype.requestAsyncId.call(this,r,n,o):(r.actions.push(this),r._scheduled||(r._scheduled=at.requestAnimationFrame(function(){return r.flush(void 0)})))},t.prototype.recycleAsyncId=function(r,n,o){var i;if(o===void 0&&(o=0),o!=null?o>0:this.delay>0)return e.prototype.recycleAsyncId.call(this,r,n,o);var s=r.actions;n!=null&&((i=s[s.length-1])===null||i===void 0?void 0:i.id)!==n&&(at.cancelAnimationFrame(n),r._scheduled=void 0)},t}(zt);var Gn=function(e){ne(t,e);function t(){return e!==null&&e.apply(this,arguments)||this}return t.prototype.flush=function(r){this._active=!0;var n=this._scheduled;this._scheduled=void 0;var o=this.actions,i;r=r||o.shift();do if(i=r.execute(r.state,r.delay))break;while((r=o[0])&&r.id===n&&o.shift());if(this._active=!1,i){for(;(r=o[0])&&r.id===n&&o.shift();)r.unsubscribe();throw i}},t}(Nt);var xe=new Gn(Bn);var R=new F(function(e){return e.complete()});function qt(e){return e&&L(e.schedule)}function Hr(e){return e[e.length-1]}function Ve(e){return L(Hr(e))?e.pop():void 0}function Ee(e){return qt(Hr(e))?e.pop():void 0}function Kt(e,t){return typeof Hr(e)=="number"?e.pop():t}var st=function(e){return e&&typeof e.length=="number"&&typeof e!="function"};function Qt(e){return L(e==null?void 0:e.then)}function Yt(e){return L(e[it])}function Bt(e){return Symbol.asyncIterator&&L(e==null?void 0:e[Symbol.asyncIterator])}function Gt(e){return new TypeError("You provided "+(e!==null&&typeof e=="object"?"an invalid object":"'"+e+"'")+" where a stream was expected. You can provide an Observable, Promise, ReadableStream, Array, AsyncIterable, or Iterable.")}function ya(){return typeof Symbol!="function"||!Symbol.iterator?"@@iterator":Symbol.iterator}var Jt=ya();function Xt(e){return L(e==null?void 0:e[Jt])}function Zt(e){return jn(this,arguments,function(){var r,n,o,i;return It(this,function(s){switch(s.label){case 0:r=e.getReader(),s.label=1;case 1:s.trys.push([1,,9,10]),s.label=2;case 2:return[4,jt(r.read())];case 3:return n=s.sent(),o=n.value,i=n.done,i?[4,jt(void 0)]:[3,5];case 4:return[2,s.sent()];case 5:return[4,jt(o)];case 6:return[4,s.sent()];case 7:return s.sent(),[3,2];case 8:return[3,10];case 9:return r.releaseLock(),[7];case 10:return[2]}})})}function er(e){return L(e==null?void 0:e.getReader)}function z(e){if(e instanceof F)return e;if(e!=null){if(Yt(e))return xa(e);if(st(e))return wa(e);if(Qt(e))return Ea(e);if(Bt(e))return Jn(e);if(Xt(e))return Sa(e);if(er(e))return Oa(e)}throw Gt(e)}function xa(e){return new F(function(t){var r=e[it]();if(L(r.subscribe))return r.subscribe(t);throw new TypeError("Provided object does not correctly implement Symbol.observable")})}function wa(e){return new F(function(t){for(var r=0;r=2,!0))}function ie(e){e===void 0&&(e={});var t=e.connector,r=t===void 0?function(){return new E}:t,n=e.resetOnError,o=n===void 0?!0:n,i=e.resetOnComplete,s=i===void 0?!0:i,a=e.resetOnRefCountZero,c=a===void 0?!0:a;return function(f){var u,p,l,d=0,h=!1,b=!1,U=function(){p==null||p.unsubscribe(),p=void 0},G=function(){U(),u=l=void 0,h=b=!1},W=function(){var _=u;G(),_==null||_.unsubscribe()};return g(function(_,We){d++,!b&&!h&&U();var Fe=l=l!=null?l:r();We.add(function(){d--,d===0&&!b&&!h&&(p=Dr(W,c))}),Fe.subscribe(We),!u&&d>0&&(u=new Ge({next:function(Pe){return Fe.next(Pe)},error:function(Pe){b=!0,U(),p=Dr(G,o,Pe),Fe.error(Pe)},complete:function(){h=!0,U(),p=Dr(G,s),Fe.complete()}}),z(_).subscribe(u))})(f)}}function Dr(e,t){for(var r=[],n=2;ne.next(document)),e}function Q(e,t=document){return Array.from(t.querySelectorAll(e))}function K(e,t=document){let r=pe(e,t);if(typeof r=="undefined")throw new ReferenceError(`Missing element: expected "${e}" to be present`);return r}function pe(e,t=document){return t.querySelector(e)||void 0}function Ie(){return document.activeElement instanceof HTMLElement&&document.activeElement||void 0}function nr(e){return A(v(document.body,"focusin"),v(document.body,"focusout")).pipe(Re(1),m(()=>{let t=Ie();return typeof t!="undefined"?e.contains(t):!1}),N(e===Ie()),B())}function qe(e){return{x:e.offsetLeft,y:e.offsetTop}}function yo(e){return A(v(window,"load"),v(window,"resize")).pipe(Ae(0,xe),m(()=>qe(e)),N(qe(e)))}function or(e){return{x:e.scrollLeft,y:e.scrollTop}}function pt(e){return A(v(e,"scroll"),v(window,"resize")).pipe(Ae(0,xe),m(()=>or(e)),N(or(e)))}var wo=function(){if(typeof Map!="undefined")return Map;function e(t,r){var n=-1;return t.some(function(o,i){return o[0]===r?(n=i,!0):!1}),n}return function(){function t(){this.__entries__=[]}return Object.defineProperty(t.prototype,"size",{get:function(){return this.__entries__.length},enumerable:!0,configurable:!0}),t.prototype.get=function(r){var n=e(this.__entries__,r),o=this.__entries__[n];return o&&o[1]},t.prototype.set=function(r,n){var o=e(this.__entries__,r);~o?this.__entries__[o][1]=n:this.__entries__.push([r,n])},t.prototype.delete=function(r){var n=this.__entries__,o=e(n,r);~o&&n.splice(o,1)},t.prototype.has=function(r){return!!~e(this.__entries__,r)},t.prototype.clear=function(){this.__entries__.splice(0)},t.prototype.forEach=function(r,n){n===void 0&&(n=null);for(var o=0,i=this.__entries__;o0},e.prototype.connect_=function(){!qr||this.connected_||(document.addEventListener("transitionend",this.onTransitionEnd_),window.addEventListener("resize",this.refresh),Ka?(this.mutationsObserver_=new MutationObserver(this.refresh),this.mutationsObserver_.observe(document,{attributes:!0,childList:!0,characterData:!0,subtree:!0})):(document.addEventListener("DOMSubtreeModified",this.refresh),this.mutationEventsAdded_=!0),this.connected_=!0)},e.prototype.disconnect_=function(){!qr||!this.connected_||(document.removeEventListener("transitionend",this.onTransitionEnd_),window.removeEventListener("resize",this.refresh),this.mutationsObserver_&&this.mutationsObserver_.disconnect(),this.mutationEventsAdded_&&document.removeEventListener("DOMSubtreeModified",this.refresh),this.mutationsObserver_=null,this.mutationEventsAdded_=!1,this.connected_=!1)},e.prototype.onTransitionEnd_=function(t){var r=t.propertyName,n=r===void 0?"":r,o=qa.some(function(i){return!!~n.indexOf(i)});o&&this.refresh()},e.getInstance=function(){return this.instance_||(this.instance_=new e),this.instance_},e.instance_=null,e}(),Eo=function(e,t){for(var r=0,n=Object.keys(t);r0},e}(),Oo=typeof WeakMap!="undefined"?new WeakMap:new wo,_o=function(){function e(t){if(!(this instanceof e))throw new TypeError("Cannot call a class as a function.");if(!arguments.length)throw new TypeError("1 argument required, but only 0 present.");var r=Qa.getInstance(),n=new ns(t,r,this);Oo.set(this,n)}return e}();["observe","unobserve","disconnect"].forEach(function(e){_o.prototype[e]=function(){var t;return(t=Oo.get(this))[e].apply(t,arguments)}});var os=function(){return typeof ir.ResizeObserver!="undefined"?ir.ResizeObserver:_o}(),To=os;var Mo=new E,is=P(()=>I(new To(e=>{for(let t of e)Mo.next(t)}))).pipe(S(e=>A(Se,I(e)).pipe(C(()=>e.disconnect()))),X(1));function he(e){return{width:e.offsetWidth,height:e.offsetHeight}}function ve(e){return is.pipe(w(t=>t.observe(e)),S(t=>Mo.pipe(x(({target:r})=>r===e),C(()=>t.unobserve(e)),m(()=>he(e)))),N(he(e)))}function mt(e){return{width:e.scrollWidth,height:e.scrollHeight}}function cr(e){let t=e.parentElement;for(;t&&(e.scrollWidth<=t.scrollWidth&&e.scrollHeight<=t.scrollHeight);)t=(e=t).parentElement;return t?e:void 0}var Lo=new E,as=P(()=>I(new IntersectionObserver(e=>{for(let t of e)Lo.next(t)},{threshold:0}))).pipe(S(e=>A(Se,I(e)).pipe(C(()=>e.disconnect()))),X(1));function fr(e){return as.pipe(w(t=>t.observe(e)),S(t=>Lo.pipe(x(({target:r})=>r===e),C(()=>t.unobserve(e)),m(({isIntersecting:r})=>r))))}function Ao(e,t=16){return pt(e).pipe(m(({y:r})=>{let n=he(e),o=mt(e);return r>=o.height-n.height-t}),B())}var ur={drawer:K("[data-md-toggle=drawer]"),search:K("[data-md-toggle=search]")};function Co(e){return ur[e].checked}function Ke(e,t){ur[e].checked!==t&&ur[e].click()}function dt(e){let t=ur[e];return v(t,"change").pipe(m(()=>t.checked),N(t.checked))}function ss(e,t){switch(e.constructor){case HTMLInputElement:return e.type==="radio"?/^Arrow/.test(t):!0;case HTMLSelectElement:case HTMLTextAreaElement:return!0;default:return e.isContentEditable}}function Ro(){return v(window,"keydown").pipe(x(e=>!(e.metaKey||e.ctrlKey)),m(e=>({mode:Co("search")?"search":"global",type:e.key,claim(){e.preventDefault(),e.stopPropagation()}})),x(({mode:e,type:t})=>{if(e==="global"){let r=Ie();if(typeof r!="undefined")return!ss(r,t)}return!0}),ie())}function Oe(){return new URL(location.href)}function pr(e){location.href=e.href}function ko(){return new E}function Ho(e,t){if(typeof t=="string"||typeof t=="number")e.innerHTML+=t.toString();else if(t instanceof Node)e.appendChild(t);else if(Array.isArray(t))for(let r of t)Ho(e,r)}function M(e,t,...r){let n=document.createElement(e);if(t)for(let o of Object.keys(t))typeof t[o]!="undefined"&&(typeof t[o]!="boolean"?n.setAttribute(o,t[o]):n.setAttribute(o,""));for(let o of r)Ho(n,o);return n}function Po(e,t){let r=t;if(e.length>r){for(;e[r]!==" "&&--r>0;);return`${e.substring(0,r)}...`}return e}function lr(e){if(e>999){let t=+((e-950)%1e3>99);return`${((e+1e-6)/1e3).toFixed(t)}k`}else return e.toString()}function $o(){return location.hash.substring(1)}function Io(e){let t=M("a",{href:e});t.addEventListener("click",r=>r.stopPropagation()),t.click()}function cs(){return v(window,"hashchange").pipe(m($o),N($o()),x(e=>e.length>0),X(1))}function jo(){return cs().pipe(m(e=>pe(`[id="${e}"]`)),x(e=>typeof e!="undefined"))}function Kr(e){let t=matchMedia(e);return rr(r=>t.addListener(()=>r(t.matches))).pipe(N(t.matches))}function Fo(){let e=matchMedia("print");return A(v(window,"beforeprint").pipe(m(()=>!0)),v(window,"afterprint").pipe(m(()=>!1))).pipe(N(e.matches))}function Qr(e,t){return e.pipe(S(r=>r?t():R))}function mr(e,t={credentials:"same-origin"}){return ue(fetch(`${e}`,t)).pipe(ce(()=>R),S(r=>r.status!==200?Ot(()=>new Error(r.statusText)):I(r)))}function je(e,t){return mr(e,t).pipe(S(r=>r.json()),X(1))}function Uo(e,t){let r=new DOMParser;return mr(e,t).pipe(S(n=>n.text()),m(n=>r.parseFromString(n,"text/xml")),X(1))}function Do(e){let t=M("script",{src:e});return P(()=>(document.head.appendChild(t),A(v(t,"load"),v(t,"error").pipe(S(()=>Ot(()=>new ReferenceError(`Invalid script: ${e}`))))).pipe(m(()=>{}),C(()=>document.head.removeChild(t)),oe(1))))}function Wo(){return{x:Math.max(0,scrollX),y:Math.max(0,scrollY)}}function Vo(){return A(v(window,"scroll",{passive:!0}),v(window,"resize",{passive:!0})).pipe(m(Wo),N(Wo()))}function zo(){return{width:innerWidth,height:innerHeight}}function No(){return v(window,"resize",{passive:!0}).pipe(m(zo),N(zo()))}function qo(){return Y([Vo(),No()]).pipe(m(([e,t])=>({offset:e,size:t})),X(1))}function dr(e,{viewport$:t,header$:r}){let n=t.pipe(J("size")),o=Y([n,r]).pipe(m(()=>qe(e)));return Y([r,t,o]).pipe(m(([{height:i},{offset:s,size:a},{x:c,y:f}])=>({offset:{x:s.x-c,y:s.y-f+i},size:a})))}function Ko(e,{tx$:t}){let r=v(e,"message").pipe(m(({data:n})=>n));return t.pipe(Lt(()=>r,{leading:!0,trailing:!0}),w(n=>e.postMessage(n)),S(()=>r),ie())}var fs=K("#__config"),ht=JSON.parse(fs.textContent);ht.base=`${new URL(ht.base,Oe())}`;function le(){return ht}function Z(e){return ht.features.includes(e)}function re(e,t){return typeof t!="undefined"?ht.translations[e].replace("#",t.toString()):ht.translations[e]}function _e(e,t=document){return K(`[data-md-component=${e}]`,t)}function te(e,t=document){return Q(`[data-md-component=${e}]`,t)}function us(e){let t=K(".md-typeset > :first-child",e);return v(t,"click",{once:!0}).pipe(m(()=>K(".md-typeset",e)),m(r=>({hash:__md_hash(r.innerHTML)})))}function Qo(e){return!Z("announce.dismiss")||!e.childElementCount?R:P(()=>{let t=new E;return t.pipe(N({hash:__md_get("__announce")})).subscribe(({hash:r})=>{var n;r&&r===((n=__md_get("__announce"))!=null?n:r)&&(e.hidden=!0,__md_set("__announce",r))}),us(e).pipe(w(r=>t.next(r)),C(()=>t.complete()),m(r=>H({ref:e},r)))})}function ps(e,{target$:t}){return t.pipe(m(r=>({hidden:r!==e})))}function Yo(e,t){let r=new E;return r.subscribe(({hidden:n})=>{e.hidden=n}),ps(e,t).pipe(w(n=>r.next(n)),C(()=>r.complete()),m(n=>H({ref:e},n)))}var ii=Ye(Br());function Gr(e){return M("div",{class:"md-tooltip",id:e},M("div",{class:"md-tooltip__inner md-typeset"}))}function Bo(e,t){if(t=t?`${t}_annotation_${e}`:void 0,t){let r=t?`#${t}`:void 0;return M("aside",{class:"md-annotation",tabIndex:0},Gr(t),M("a",{href:r,class:"md-annotation__index",tabIndex:-1},M("span",{"data-md-annotation-id":e})))}else return M("aside",{class:"md-annotation",tabIndex:0},Gr(t),M("span",{class:"md-annotation__index",tabIndex:-1},M("span",{"data-md-annotation-id":e})))}function Go(e){return M("button",{class:"md-clipboard md-icon",title:re("clipboard.copy"),"data-clipboard-target":`#${e} > code`})}function Jr(e,t){let r=t&2,n=t&1,o=Object.keys(e.terms).filter(a=>!e.terms[a]).reduce((a,c)=>[...a,M("del",null,c)," "],[]).slice(0,-1),i=new URL(e.location);Z("search.highlight")&&i.searchParams.set("h",Object.entries(e.terms).filter(([,a])=>a).reduce((a,[c])=>`${a} ${c}`.trim(),""));let{tags:s}=le();return M("a",{href:`${i}`,class:"md-search-result__link",tabIndex:-1},M("article",{class:["md-search-result__article",...r?["md-search-result__article--document"]:[]].join(" "),"data-md-score":e.score.toFixed(2)},r>0&&M("div",{class:"md-search-result__icon md-icon"}),M("h1",{class:"md-search-result__title"},e.title),n>0&&e.text.length>0&&M("p",{class:"md-search-result__teaser"},Po(e.text,320)),e.tags&&M("div",{class:"md-typeset"},e.tags.map(a=>{let c=a.replace(/<[^>]+>/g,""),f=s?c in s?`md-tag-icon md-tag-icon--${s[c]}`:"md-tag-icon":"";return M("span",{class:`md-tag ${f}`},a)})),n>0&&o.length>0&&M("p",{class:"md-search-result__terms"},re("search.result.term.missing"),": ",...o)))}function Jo(e){let t=e[0].score,r=[...e],n=r.findIndex(f=>!f.location.includes("#")),[o]=r.splice(n,1),i=r.findIndex(f=>f.scoreJr(f,1)),...a.length?[M("details",{class:"md-search-result__more"},M("summary",{tabIndex:-1},a.length>0&&a.length===1?re("search.result.more.one"):re("search.result.more.other",a.length)),...a.map(f=>Jr(f,1)))]:[]];return M("li",{class:"md-search-result__item"},c)}function Xo(e){return M("ul",{class:"md-source__facts"},Object.entries(e).map(([t,r])=>M("li",{class:`md-source__fact md-source__fact--${t}`},typeof r=="number"?lr(r):r)))}function Xr(e){let t=`tabbed-control tabbed-control--${e}`;return M("div",{class:t,hidden:!0},M("button",{class:"tabbed-button",tabIndex:-1}))}function Zo(e){return M("div",{class:"md-typeset__scrollwrap"},M("div",{class:"md-typeset__table"},e))}function ls(e){let t=le(),r=new URL(`../${e.version}/`,t.base);return M("li",{class:"md-version__item"},M("a",{href:`${r}`,class:"md-version__link"},e.title))}function ei(e,t){return M("div",{class:"md-version"},M("button",{class:"md-version__current","aria-label":re("select.version.title")},t.title),M("ul",{class:"md-version__list"},e.map(ls)))}function ms(e,t){let r=P(()=>Y([yo(e),pt(t)])).pipe(m(([{x:n,y:o},i])=>{let{width:s,height:a}=he(e);return{x:n-i.x+s/2,y:o-i.y+a/2}}));return nr(e).pipe(S(n=>r.pipe(m(o=>({active:n,offset:o})),oe(+!n||1/0))))}function ti(e,t,{target$:r}){let[n,o]=Array.from(e.children);return P(()=>{let i=new E,s=i.pipe(de(1));return i.subscribe({next({offset:a}){e.style.setProperty("--md-tooltip-x",`${a.x}px`),e.style.setProperty("--md-tooltip-y",`${a.y}px`)},complete(){e.style.removeProperty("--md-tooltip-x"),e.style.removeProperty("--md-tooltip-y")}}),fr(e).pipe(ee(s)).subscribe(a=>{e.toggleAttribute("data-md-visible",a)}),A(i.pipe(x(({active:a})=>a)),i.pipe(Re(250),x(({active:a})=>!a))).subscribe({next({active:a}){a?e.prepend(n):n.remove()},complete(){e.prepend(n)}}),i.pipe(Ae(16,xe)).subscribe(({active:a})=>{n.classList.toggle("md-tooltip--active",a)}),i.pipe(zr(125,xe),x(()=>!!e.offsetParent),m(()=>e.offsetParent.getBoundingClientRect()),m(({x:a})=>a)).subscribe({next(a){a?e.style.setProperty("--md-tooltip-0",`${-a}px`):e.style.removeProperty("--md-tooltip-0")},complete(){e.style.removeProperty("--md-tooltip-0")}}),v(o,"click").pipe(ee(s),x(a=>!(a.metaKey||a.ctrlKey))).subscribe(a=>a.preventDefault()),v(o,"mousedown").pipe(ee(s),ae(i)).subscribe(([a,{active:c}])=>{var f;if(a.button!==0||a.metaKey||a.ctrlKey)a.preventDefault();else if(c){a.preventDefault();let u=e.parentElement.closest(".md-annotation");u instanceof HTMLElement?u.focus():(f=Ie())==null||f.blur()}}),r.pipe(ee(s),x(a=>a===n),ke(125)).subscribe(()=>e.focus()),ms(e,t).pipe(w(a=>i.next(a)),C(()=>i.complete()),m(a=>H({ref:e},a)))})}function ds(e){let t=[];for(let r of Q(".c, .c1, .cm",e)){let n=[],o=document.createNodeIterator(r,NodeFilter.SHOW_TEXT);for(let i=o.nextNode();i;i=o.nextNode())n.push(i);for(let i of n){let s;for(;s=/(\(\d+\))(!)?/.exec(i.textContent);){let[,a,c]=s;if(typeof c=="undefined"){let f=i.splitText(s.index);i=f.splitText(a.length),t.push(f)}else{i.textContent=a,t.push(i);break}}}}return t}function ri(e,t){t.append(...Array.from(e.childNodes))}function ni(e,t,{target$:r,print$:n}){let o=t.closest("[id]"),i=o==null?void 0:o.id,s=new Map;for(let a of ds(t)){let[,c]=a.textContent.match(/\((\d+)\)/);pe(`li:nth-child(${c})`,e)&&(s.set(c,Bo(c,i)),a.replaceWith(s.get(c)))}return s.size===0?R:P(()=>{let a=new E,c=[];for(let[f,u]of s)c.push([K(".md-typeset",u),K(`li:nth-child(${f})`,e)]);return n.pipe(ee(a.pipe(de(1)))).subscribe(f=>{e.hidden=!f;for(let[u,p]of c)f?ri(u,p):ri(p,u)}),A(...[...s].map(([,f])=>ti(f,t,{target$:r}))).pipe(C(()=>a.complete()),ie())})}var hs=0;function ai(e){if(e.nextElementSibling){let t=e.nextElementSibling;if(t.tagName==="OL")return t;if(t.tagName==="P"&&!t.children.length)return ai(t)}}function oi(e){return ve(e).pipe(m(({width:t})=>({scrollable:mt(e).width>t})),J("scrollable"))}function si(e,t){let{matches:r}=matchMedia("(hover)"),n=P(()=>{let o=new E;if(o.subscribe(({scrollable:s})=>{s&&r?e.setAttribute("tabindex","0"):e.removeAttribute("tabindex")}),ii.default.isSupported()){let s=e.closest("pre");s.id=`__code_${++hs}`,s.insertBefore(Go(s.id),e)}let i=e.closest(".highlight");if(i instanceof HTMLElement){let s=ai(i);if(typeof s!="undefined"&&(i.classList.contains("annotate")||Z("content.code.annotate"))){let a=ni(s,e,t);return oi(e).pipe(w(c=>o.next(c)),C(()=>o.complete()),m(c=>H({ref:e},c)),et(ve(i).pipe(m(({width:c,height:f})=>c&&f),B(),S(c=>c?a:R))))}}return oi(e).pipe(w(s=>o.next(s)),C(()=>o.complete()),m(s=>H({ref:e},s)))});return Z("content.lazy")?fr(e).pipe(x(o=>o),oe(1),S(()=>n)):n}var ci=".node circle,.node ellipse,.node path,.node polygon,.node rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}marker{fill:var(--md-mermaid-edge-color)!important}.edgeLabel .label rect{fill:transparent}.label{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.label foreignObject{line-height:normal;overflow:visible}.label div .edgeLabel{color:var(--md-mermaid-label-fg-color)}.edgeLabel,.edgeLabel rect,.label div .edgeLabel{background-color:var(--md-mermaid-label-bg-color)}.edgeLabel,.edgeLabel rect{fill:var(--md-mermaid-label-bg-color);color:var(--md-mermaid-edge-color)}.edgePath .path,.flowchart-link{stroke:var(--md-mermaid-edge-color)}.edgePath .arrowheadPath{fill:var(--md-mermaid-edge-color);stroke:none}.cluster rect{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}.cluster span{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}defs #flowchart-circleEnd,defs #flowchart-circleStart,defs #flowchart-crossEnd,defs #flowchart-crossStart,defs #flowchart-pointEnd,defs #flowchart-pointStart{stroke:none}g.classGroup line,g.classGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.classGroup text{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.classLabel .box{fill:var(--md-mermaid-label-bg-color);background-color:var(--md-mermaid-label-bg-color);opacity:1}.classLabel .label{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node .divider{stroke:var(--md-mermaid-node-fg-color)}.relation{stroke:var(--md-mermaid-edge-color)}.cardinality{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.cardinality text{fill:inherit!important}defs #classDiagram-compositionEnd,defs #classDiagram-compositionStart,defs #classDiagram-dependencyEnd,defs #classDiagram-dependencyStart,defs #classDiagram-extensionEnd,defs #classDiagram-extensionStart{fill:var(--md-mermaid-edge-color)!important;stroke:var(--md-mermaid-edge-color)!important}defs #classDiagram-aggregationEnd,defs #classDiagram-aggregationStart{fill:var(--md-mermaid-label-bg-color)!important;stroke:var(--md-mermaid-edge-color)!important}g.stateGroup rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}g.stateGroup .state-title{fill:var(--md-mermaid-label-fg-color)!important;font-family:var(--md-mermaid-font-family)}g.stateGroup .composit{fill:var(--md-mermaid-label-bg-color)}.nodeLabel{color:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.node circle.state-end,.node circle.state-start,.start-state{fill:var(--md-mermaid-edge-color);stroke:none}.end-state-inner,.end-state-outer{fill:var(--md-mermaid-edge-color)}.end-state-inner,.node circle.state-end{stroke:var(--md-mermaid-label-bg-color)}.transition{stroke:var(--md-mermaid-edge-color)}[id^=state-fork] rect,[id^=state-join] rect{fill:var(--md-mermaid-edge-color)!important;stroke:none!important}.statediagram-cluster.statediagram-cluster .inner{fill:var(--md-default-bg-color)}.statediagram-cluster rect{fill:var(--md-mermaid-node-bg-color);stroke:var(--md-mermaid-node-fg-color)}.statediagram-state rect.divider{fill:var(--md-default-fg-color--lightest);stroke:var(--md-default-fg-color--lighter)}defs #statediagram-barbEnd{stroke:var(--md-mermaid-edge-color)}.entityBox{fill:var(--md-mermaid-label-bg-color);stroke:var(--md-mermaid-node-fg-color)}.entityLabel{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}.relationshipLabelBox{fill:var(--md-mermaid-label-bg-color);fill-opacity:1;background-color:var(--md-mermaid-label-bg-color);opacity:1}.relationshipLabel{fill:var(--md-mermaid-label-fg-color)}.relationshipLine{stroke:var(--md-mermaid-edge-color)}defs #ONE_OR_MORE_END *,defs #ONE_OR_MORE_START *,defs #ONLY_ONE_END *,defs #ONLY_ONE_START *,defs #ZERO_OR_MORE_END *,defs #ZERO_OR_MORE_START *,defs #ZERO_OR_ONE_END *,defs #ZERO_OR_ONE_START *{stroke:var(--md-mermaid-edge-color)!important}.actor,defs #ZERO_OR_MORE_END circle,defs #ZERO_OR_MORE_START circle{fill:var(--md-mermaid-label-bg-color)}.actor{stroke:var(--md-mermaid-node-fg-color)}text.actor>tspan{fill:var(--md-mermaid-label-fg-color);font-family:var(--md-mermaid-font-family)}line{stroke:var(--md-default-fg-color--lighter)}.messageLine0,.messageLine1{stroke:var(--md-mermaid-edge-color)}.loopText>tspan,.messageText,.noteText>tspan{font-family:var(--md-mermaid-font-family)!important}#arrowhead path,.loopText>tspan,.messageText,.noteText>tspan{fill:var(--md-mermaid-edge-color);stroke:none}.loopLine{stroke:var(--md-mermaid-node-fg-color)}.labelBox,.loopLine{fill:var(--md-mermaid-node-bg-color)}.labelBox{stroke:none}.labelText,.labelText>span{fill:var(--md-mermaid-node-fg-color);font-family:var(--md-mermaid-font-family)}";var Zr,vs=0;function gs(){return typeof mermaid=="undefined"||mermaid instanceof Element?Do("https://unpkg.com/mermaid@9.1.7/dist/mermaid.min.js"):I(void 0)}function fi(e){return e.classList.remove("mermaid"),Zr||(Zr=gs().pipe(w(()=>mermaid.initialize({startOnLoad:!1,themeCSS:ci,sequence:{actorFontSize:"16px",messageFontSize:"16px",noteFontSize:"16px"}})),m(()=>{}),X(1))),Zr.subscribe(()=>{e.classList.add("mermaid");let t=`__mermaid_${vs++}`,r=M("div",{class:"mermaid"});mermaid.mermaidAPI.render(t,e.textContent,n=>{let o=r.attachShadow({mode:"closed"});o.innerHTML=n,e.replaceWith(r)})}),Zr.pipe(m(()=>({ref:e})))}function ys(e,{target$:t,print$:r}){let n=!0;return A(t.pipe(m(o=>o.closest("details:not([open])")),x(o=>e===o),m(()=>({action:"open",reveal:!0}))),r.pipe(x(o=>o||!n),w(()=>n=e.open),m(o=>({action:o?"open":"close"}))))}function ui(e,t){return P(()=>{let r=new E;return r.subscribe(({action:n,reveal:o})=>{e.toggleAttribute("open",n==="open"),o&&e.scrollIntoView()}),ys(e,t).pipe(w(n=>r.next(n)),C(()=>r.complete()),m(n=>H({ref:e},n)))})}var pi=M("table");function li(e){return e.replaceWith(pi),pi.replaceWith(Zo(e)),I({ref:e})}function xs(e){let t=Q(":scope > input",e),r=t.find(n=>n.checked)||t[0];return A(...t.map(n=>v(n,"change").pipe(m(()=>K(`label[for="${n.id}"]`))))).pipe(N(K(`label[for="${r.id}"]`)),m(n=>({active:n})))}function mi(e,{viewport$:t}){let r=Xr("prev");e.append(r);let n=Xr("next");e.append(n);let o=K(".tabbed-labels",e);return P(()=>{let i=new E,s=i.pipe(de(1));return Y([i,ve(e)]).pipe(Ae(1,xe),ee(s)).subscribe({next([{active:a},c]){let f=qe(a),{width:u}=he(a);e.style.setProperty("--md-indicator-x",`${f.x}px`),e.style.setProperty("--md-indicator-width",`${u}px`);let p=or(o);(f.xp.x+c.width)&&o.scrollTo({left:Math.max(0,f.x-16),behavior:"smooth"})},complete(){e.style.removeProperty("--md-indicator-x"),e.style.removeProperty("--md-indicator-width")}}),Y([pt(o),ve(o)]).pipe(ee(s)).subscribe(([a,c])=>{let f=mt(o);r.hidden=a.x<16,n.hidden=a.x>f.width-c.width-16}),A(v(r,"click").pipe(m(()=>-1)),v(n,"click").pipe(m(()=>1))).pipe(ee(s)).subscribe(a=>{let{width:c}=he(o);o.scrollBy({left:c*a,behavior:"smooth"})}),Z("content.tabs.link")&&i.pipe(He(1),ae(t)).subscribe(([{active:a},{offset:c}])=>{let f=a.innerText.trim();if(a.hasAttribute("data-md-switching"))a.removeAttribute("data-md-switching");else{let u=e.offsetTop-c.y;for(let l of Q("[data-tabs]"))for(let d of Q(":scope > input",l)){let h=K(`label[for="${d.id}"]`);if(h!==a&&h.innerText.trim()===f){h.setAttribute("data-md-switching",""),d.click();break}}window.scrollTo({top:e.offsetTop-u});let p=__md_get("__tabs")||[];__md_set("__tabs",[...new Set([f,...p])])}}),xs(e).pipe(w(a=>i.next(a)),C(()=>i.complete()),m(a=>H({ref:e},a)))}).pipe(Je(fe))}function di(e,{viewport$:t,target$:r,print$:n}){return A(...Q("pre:not(.mermaid) > code",e).map(o=>si(o,{target$:r,print$:n})),...Q("pre.mermaid",e).map(o=>fi(o)),...Q("table:not([class])",e).map(o=>li(o)),...Q("details",e).map(o=>ui(o,{target$:r,print$:n})),...Q("[data-tabs]",e).map(o=>mi(o,{viewport$:t})))}function ws(e,{alert$:t}){return t.pipe(S(r=>A(I(!0),I(!1).pipe(ke(2e3))).pipe(m(n=>({message:r,active:n})))))}function hi(e,t){let r=K(".md-typeset",e);return P(()=>{let n=new E;return n.subscribe(({message:o,active:i})=>{e.classList.toggle("md-dialog--active",i),r.textContent=o}),ws(e,t).pipe(w(o=>n.next(o)),C(()=>n.complete()),m(o=>H({ref:e},o)))})}function Es({viewport$:e}){if(!Z("header.autohide"))return I(!1);let t=e.pipe(m(({offset:{y:o}})=>o),Ce(2,1),m(([o,i])=>[oMath.abs(i-o.y)>100),m(([,[o]])=>o),B()),n=dt("search");return Y([e,n]).pipe(m(([{offset:o},i])=>o.y>400&&!i),B(),S(o=>o?r:I(!1)),N(!1))}function bi(e,t){return P(()=>Y([ve(e),Es(t)])).pipe(m(([{height:r},n])=>({height:r,hidden:n})),B((r,n)=>r.height===n.height&&r.hidden===n.hidden),X(1))}function vi(e,{header$:t,main$:r}){return P(()=>{let n=new E,o=n.pipe(de(1));return n.pipe(J("active"),Ze(t)).subscribe(([{active:i},{hidden:s}])=>{e.classList.toggle("md-header--shadow",i&&!s),e.hidden=s}),r.subscribe(n),t.pipe(ee(o),m(i=>H({ref:e},i)))})}function Ss(e,{viewport$:t,header$:r}){return dr(e,{viewport$:t,header$:r}).pipe(m(({offset:{y:n}})=>{let{height:o}=he(e);return{active:n>=o}}),J("active"))}function gi(e,t){return P(()=>{let r=new E;r.subscribe(({active:o})=>{e.classList.toggle("md-header__title--active",o)});let n=pe("article h1");return typeof n=="undefined"?R:Ss(n,t).pipe(w(o=>r.next(o)),C(()=>r.complete()),m(o=>H({ref:e},o)))})}function yi(e,{viewport$:t,header$:r}){let n=r.pipe(m(({height:i})=>i),B()),o=n.pipe(S(()=>ve(e).pipe(m(({height:i})=>({top:e.offsetTop,bottom:e.offsetTop+i})),J("bottom"))));return Y([n,o,t]).pipe(m(([i,{top:s,bottom:a},{offset:{y:c},size:{height:f}}])=>(f=Math.max(0,f-Math.max(0,s-c,i)-Math.max(0,f+c-a)),{offset:s-i,height:f,active:s-i<=c})),B((i,s)=>i.offset===s.offset&&i.height===s.height&&i.active===s.active))}function Os(e){let t=__md_get("__palette")||{index:e.findIndex(r=>matchMedia(r.getAttribute("data-md-color-media")).matches)};return I(...e).pipe(se(r=>v(r,"change").pipe(m(()=>r))),N(e[Math.max(0,t.index)]),m(r=>({index:e.indexOf(r),color:{scheme:r.getAttribute("data-md-color-scheme"),primary:r.getAttribute("data-md-color-primary"),accent:r.getAttribute("data-md-color-accent")}})),X(1))}function xi(e){return P(()=>{let t=new E;t.subscribe(n=>{document.body.setAttribute("data-md-color-switching","");for(let[o,i]of Object.entries(n.color))document.body.setAttribute(`data-md-color-${o}`,i);for(let o=0;o{document.body.removeAttribute("data-md-color-switching")});let r=Q("input",e);return Os(r).pipe(w(n=>t.next(n)),C(()=>t.complete()),m(n=>H({ref:e},n)))})}var en=Ye(Br());function _s(e){e.setAttribute("data-md-copying","");let t=e.innerText;return e.removeAttribute("data-md-copying"),t}function wi({alert$:e}){en.default.isSupported()&&new F(t=>{new en.default("[data-clipboard-target], [data-clipboard-text]",{text:r=>r.getAttribute("data-clipboard-text")||_s(K(r.getAttribute("data-clipboard-target")))}).on("success",r=>t.next(r))}).pipe(w(t=>{t.trigger.focus()}),m(()=>re("clipboard.copied"))).subscribe(e)}function Ts(e){if(e.length<2)return[""];let[t,r]=[...e].sort((o,i)=>o.length-i.length).map(o=>o.replace(/[^/]+$/,"")),n=0;if(t===r)n=t.length;else for(;t.charCodeAt(n)===r.charCodeAt(n);)n++;return e.map(o=>o.replace(t.slice(0,n),""))}function hr(e){let t=__md_get("__sitemap",sessionStorage,e);if(t)return I(t);{let r=le();return Uo(new URL("sitemap.xml",e||r.base)).pipe(m(n=>Ts(Q("loc",n).map(o=>o.textContent))),ce(()=>R),De([]),w(n=>__md_set("__sitemap",n,sessionStorage,e)))}}function Ei({document$:e,location$:t,viewport$:r}){let n=le();if(location.protocol==="file:")return;"scrollRestoration"in history&&(history.scrollRestoration="manual",v(window,"beforeunload").subscribe(()=>{history.scrollRestoration="auto"}));let o=pe("link[rel=icon]");typeof o!="undefined"&&(o.href=o.href);let i=hr().pipe(m(f=>f.map(u=>`${new URL(u,n.base)}`)),S(f=>v(document.body,"click").pipe(x(u=>!u.metaKey&&!u.ctrlKey),S(u=>{if(u.target instanceof Element){let p=u.target.closest("a");if(p&&!p.target){let l=new URL(p.href);if(l.search="",l.hash="",l.pathname!==location.pathname&&f.includes(l.toString()))return u.preventDefault(),I({url:new URL(p.href)})}}return Se}))),ie()),s=v(window,"popstate").pipe(x(f=>f.state!==null),m(f=>({url:new URL(location.href),offset:f.state})),ie());A(i,s).pipe(B((f,u)=>f.url.href===u.url.href),m(({url:f})=>f)).subscribe(t);let a=t.pipe(J("pathname"),S(f=>mr(f.href).pipe(ce(()=>(pr(f),Se)))),ie());i.pipe(ut(a)).subscribe(({url:f})=>{history.pushState({},"",`${f}`)});let c=new DOMParser;a.pipe(S(f=>f.text()),m(f=>c.parseFromString(f,"text/html"))).subscribe(e),e.pipe(He(1)).subscribe(f=>{for(let u of["title","link[rel=canonical]","meta[name=author]","meta[name=description]","[data-md-component=announce]","[data-md-component=container]","[data-md-component=header-topic]","[data-md-component=outdated]","[data-md-component=logo]","[data-md-component=skip]",...Z("navigation.tabs.sticky")?["[data-md-component=tabs]"]:[]]){let p=pe(u),l=pe(u,f);typeof p!="undefined"&&typeof l!="undefined"&&p.replaceWith(l)}}),e.pipe(He(1),m(()=>_e("container")),S(f=>Q("script",f)),Ir(f=>{let u=M("script");if(f.src){for(let p of f.getAttributeNames())u.setAttribute(p,f.getAttribute(p));return f.replaceWith(u),new F(p=>{u.onload=()=>p.complete()})}else return u.textContent=f.textContent,f.replaceWith(u),R})).subscribe(),A(i,s).pipe(ut(e)).subscribe(({url:f,offset:u})=>{f.hash&&!u?Io(f.hash):window.scrollTo(0,(u==null?void 0:u.y)||0)}),r.pipe(Mt(i),Re(250),J("offset")).subscribe(({offset:f})=>{history.replaceState(f,"")}),A(i,s).pipe(Ce(2,1),x(([f,u])=>f.url.pathname===u.url.pathname),m(([,f])=>f)).subscribe(({offset:f})=>{window.scrollTo(0,(f==null?void 0:f.y)||0)})}var As=Ye(tn());var Oi=Ye(tn());function rn(e,t){let r=new RegExp(e.separator,"img"),n=(o,i,s)=>`${i}${s}`;return o=>{o=o.replace(/[\s*+\-:~^]+/g," ").trim();let i=new RegExp(`(^|${e.separator})(${o.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return s=>(t?(0,Oi.default)(s):s).replace(i,n).replace(/<\/mark>(\s+)]*>/img,"$1")}}function _i(e){return e.split(/"([^"]+)"/g).map((t,r)=>r&1?t.replace(/^\b|^(?![^\x00-\x7F]|$)|\s+/g," +"):t).join("").replace(/"|(?:^|\s+)[*+\-:^~]+(?=\s+|$)/g,"").trim()}function bt(e){return e.type===1}function Ti(e){return e.type===2}function vt(e){return e.type===3}function Rs({config:e,docs:t}){e.lang.length===1&&e.lang[0]==="en"&&(e.lang=[re("search.config.lang")]),e.separator==="[\\s\\-]+"&&(e.separator=re("search.config.separator"));let n={pipeline:re("search.config.pipeline").split(/\s*,\s*/).filter(Boolean),suggestions:Z("search.suggest")};return{config:e,docs:t,options:n}}function Mi(e,t){let r=le(),n=new Worker(e),o=new E,i=Ko(n,{tx$:o}).pipe(m(s=>{if(vt(s))for(let a of s.data.items)for(let c of a)c.location=`${new URL(c.location,r.base)}`;return s}),ie());return ue(t).pipe(m(s=>({type:0,data:Rs(s)}))).subscribe(o.next.bind(o)),{tx$:o,rx$:i}}function Li({document$:e}){let t=le(),r=je(new URL("../versions.json",t.base)).pipe(ce(()=>R)),n=r.pipe(m(o=>{let[,i]=t.base.match(/([^/]+)\/?$/);return o.find(({version:s,aliases:a})=>s===i||a.includes(i))||o[0]}));r.pipe(m(o=>new Map(o.map(i=>[`${new URL(`../${i.version}/`,t.base)}`,i]))),S(o=>v(document.body,"click").pipe(x(i=>!i.metaKey&&!i.ctrlKey),ae(n),S(([i,s])=>{if(i.target instanceof Element){let a=i.target.closest("a");if(a&&!a.target&&o.has(a.href)){let c=a.href;return!i.target.closest(".md-version")&&o.get(c)===s?R:(i.preventDefault(),I(c))}}return R}),S(i=>{let{version:s}=o.get(i);return hr(new URL(i)).pipe(m(a=>{let f=Oe().href.replace(t.base,"");return a.includes(f.split("#")[0])?new URL(`../${s}/${f}`,t.base):new URL(i)}))})))).subscribe(o=>pr(o)),Y([r,n]).subscribe(([o,i])=>{K(".md-header__topic").appendChild(ei(o,i))}),e.pipe(S(()=>n)).subscribe(o=>{var s;let i=__md_get("__outdated",sessionStorage);if(i===null){let a=((s=t.version)==null?void 0:s.default)||"latest";i=!o.aliases.includes(a),__md_set("__outdated",i,sessionStorage)}if(i)for(let a of te("outdated"))a.hidden=!1})}function ks(e,{rx$:t}){let r=(__search==null?void 0:__search.transform)||_i,{searchParams:n}=Oe();n.has("q")&&Ke("search",!0);let o=t.pipe(x(bt),oe(1),m(()=>n.get("q")||""));dt("search").pipe(x(a=>!a),oe(1)).subscribe(()=>{let a=new URL(location.href);a.searchParams.delete("q"),history.replaceState({},"",`${a}`)}),o.subscribe(a=>{a&&(e.value=a,e.focus())});let i=nr(e),s=A(v(e,"keyup"),v(e,"focus").pipe(ke(1)),o).pipe(m(()=>r(e.value)),N(""),B());return Y([s,i]).pipe(m(([a,c])=>({value:a,focus:c})),X(1))}function Ai(e,{tx$:t,rx$:r}){let n=new E,o=n.pipe(de(1));return n.pipe(J("value"),m(({value:i})=>({type:2,data:i}))).subscribe(t.next.bind(t)),n.pipe(J("focus")).subscribe(({focus:i})=>{i?(Ke("search",i),e.placeholder=""):e.placeholder=re("search.placeholder")}),v(e.form,"reset").pipe(ee(o)).subscribe(()=>e.focus()),ks(e,{tx$:t,rx$:r}).pipe(w(i=>n.next(i)),C(()=>n.complete()),m(i=>H({ref:e},i)),ie())}function Ci(e,{rx$:t},{query$:r}){let n=new E,o=Ao(e.parentElement).pipe(x(Boolean)),i=K(":scope > :first-child",e),s=K(":scope > :last-child",e),a=t.pipe(x(bt),oe(1));return n.pipe(ae(r),Mt(a)).subscribe(([{items:f},{value:u}])=>{if(u)switch(f.length){case 0:i.textContent=re("search.result.none");break;case 1:i.textContent=re("search.result.one");break;default:i.textContent=re("search.result.other",lr(f.length))}else i.textContent=re("search.result.placeholder")}),n.pipe(w(()=>s.innerHTML=""),S(({items:f})=>A(I(...f.slice(0,10)),I(...f.slice(10)).pipe(Ce(4),Nr(o),S(([u])=>u))))).subscribe(f=>s.appendChild(Jo(f))),t.pipe(x(vt),m(({data:f})=>f)).pipe(w(f=>n.next(f)),C(()=>n.complete()),m(f=>H({ref:e},f)))}function Hs(e,{query$:t}){return t.pipe(m(({value:r})=>{let n=Oe();return n.hash="",n.searchParams.delete("h"),n.searchParams.set("q",r),{url:n}}))}function Ri(e,t){let r=new E;return r.subscribe(({url:n})=>{e.setAttribute("data-clipboard-text",e.href),e.href=`${n}`}),v(e,"click").subscribe(n=>n.preventDefault()),Hs(e,t).pipe(w(n=>r.next(n)),C(()=>r.complete()),m(n=>H({ref:e},n)))}function ki(e,{rx$:t},{keyboard$:r}){let n=new E,o=_e("search-query"),i=A(v(o,"keydown"),v(o,"focus")).pipe(Le(fe),m(()=>o.value),B());return n.pipe(Ze(i),m(([{suggestions:a},c])=>{let f=c.split(/([\s-]+)/);if((a==null?void 0:a.length)&&f[f.length-1]){let u=a[a.length-1];u.startsWith(f[f.length-1])&&(f[f.length-1]=u)}else f.length=0;return f})).subscribe(a=>e.innerHTML=a.join("").replace(/\s/g," ")),r.pipe(x(({mode:a})=>a==="search")).subscribe(a=>{switch(a.type){case"ArrowRight":e.innerText.length&&o.selectionStart===o.value.length&&(o.value=e.innerText);break}}),t.pipe(x(vt),m(({data:a})=>a)).pipe(w(a=>n.next(a)),C(()=>n.complete()),m(()=>({ref:e})))}function Hi(e,{index$:t,keyboard$:r}){let n=le();try{let o=(__search==null?void 0:__search.worker)||n.search,i=Mi(o,t),s=_e("search-query",e),a=_e("search-result",e),{tx$:c,rx$:f}=i;c.pipe(x(Ti),ut(f.pipe(x(bt))),oe(1)).subscribe(c.next.bind(c)),r.pipe(x(({mode:l})=>l==="search")).subscribe(l=>{let d=Ie();switch(l.type){case"Enter":if(d===s){let h=new Map;for(let b of Q(":first-child [href]",a)){let U=b.firstElementChild;h.set(b,parseFloat(U.getAttribute("data-md-score")))}if(h.size){let[[b]]=[...h].sort(([,U],[,G])=>G-U);b.click()}l.claim()}break;case"Escape":case"Tab":Ke("search",!1),s.blur();break;case"ArrowUp":case"ArrowDown":if(typeof d=="undefined")s.focus();else{let h=[s,...Q(":not(details) > [href], summary, details[open] [href]",a)],b=Math.max(0,(Math.max(0,h.indexOf(d))+h.length+(l.type==="ArrowUp"?-1:1))%h.length);h[b].focus()}l.claim();break;default:s!==Ie()&&s.focus()}}),r.pipe(x(({mode:l})=>l==="global")).subscribe(l=>{switch(l.type){case"f":case"s":case"/":s.focus(),s.select(),l.claim();break}});let u=Ai(s,i),p=Ci(a,i,{query$:u});return A(u,p).pipe(et(...te("search-share",e).map(l=>Ri(l,{query$:u})),...te("search-suggest",e).map(l=>ki(l,i,{keyboard$:r}))))}catch(o){return e.hidden=!0,Se}}function Pi(e,{index$:t,location$:r}){return Y([t,r.pipe(N(Oe()),x(n=>!!n.searchParams.get("h")))]).pipe(m(([n,o])=>rn(n.config,!0)(o.searchParams.get("h"))),m(n=>{var s;let o=new Map,i=document.createNodeIterator(e,NodeFilter.SHOW_TEXT);for(let a=i.nextNode();a;a=i.nextNode())if((s=a.parentElement)!=null&&s.offsetHeight){let c=a.textContent,f=n(c);f.length>c.length&&o.set(a,f)}for(let[a,c]of o){let{childNodes:f}=M("span",null,c);a.replaceWith(...Array.from(f))}return{ref:e,nodes:o}}))}function Ps(e,{viewport$:t,main$:r}){let n=e.parentElement,o=n.offsetTop-n.parentElement.offsetTop;return Y([r,t]).pipe(m(([{offset:i,height:s},{offset:{y:a}}])=>(s=s+Math.min(o,Math.max(0,a-i))-o,{height:s,locked:a>=i+o})),B((i,s)=>i.height===s.height&&i.locked===s.locked))}function nn(e,n){var o=n,{header$:t}=o,r=un(o,["header$"]);let i=K(".md-sidebar__scrollwrap",e),{y:s}=qe(i);return P(()=>{let a=new E;return a.pipe(Ae(0,xe),ae(t)).subscribe({next([{height:c},{height:f}]){i.style.height=`${c-2*s}px`,e.style.top=`${f}px`},complete(){i.style.height="",e.style.top=""}}),a.pipe(Le(xe),oe(1)).subscribe(()=>{for(let c of Q(".md-nav__link--active[href]",e)){let f=cr(c);if(typeof f!="undefined"){let u=c.offsetTop-f.offsetTop,{height:p}=he(f);f.scrollTo({top:u-p/2})}}}),Ps(e,r).pipe(w(c=>a.next(c)),C(()=>a.complete()),m(c=>H({ref:e},c)))})}function $i(e,t){if(typeof t!="undefined"){let r=`https://api.github.com/repos/${e}/${t}`;return _t(je(`${r}/releases/latest`).pipe(ce(()=>R),m(n=>({version:n.tag_name})),De({})),je(r).pipe(ce(()=>R),m(n=>({stars:n.stargazers_count,forks:n.forks_count})),De({}))).pipe(m(([n,o])=>H(H({},n),o)))}else{let r=`https://api.github.com/users/${e}`;return je(r).pipe(m(n=>({repositories:n.public_repos})),De({}))}}function Ii(e,t){let r=`https://${e}/api/v4/projects/${encodeURIComponent(t)}`;return je(r).pipe(ce(()=>R),m(({star_count:n,forks_count:o})=>({stars:n,forks:o})),De({}))}function ji(e){let[t]=e.match(/(git(?:hub|lab))/i)||[];switch(t.toLowerCase()){case"github":let[,r,n]=e.match(/^.+github\.com\/([^/]+)\/?([^/]+)?/i);return $i(r,n);case"gitlab":let[,o,i]=e.match(/^.+?([^/]*gitlab[^/]+)\/(.+?)\/?$/i);return Ii(o,i);default:return R}}var $s;function Is(e){return $s||($s=P(()=>{let t=__md_get("__source",sessionStorage);if(t)return I(t);if(te("consent").length){let n=__md_get("__consent");if(!(n&&n.github))return R}return ji(e.href).pipe(w(n=>__md_set("__source",n,sessionStorage)))}).pipe(ce(()=>R),x(t=>Object.keys(t).length>0),m(t=>({facts:t})),X(1)))}function Fi(e){let t=K(":scope > :last-child",e);return P(()=>{let r=new E;return r.subscribe(({facts:n})=>{t.appendChild(Xo(n)),t.classList.add("md-source__repository--active")}),Is(e).pipe(w(n=>r.next(n)),C(()=>r.complete()),m(n=>H({ref:e},n)))})}function js(e,{viewport$:t,header$:r}){return ve(document.body).pipe(S(()=>dr(e,{header$:r,viewport$:t})),m(({offset:{y:n}})=>({hidden:n>=10})),J("hidden"))}function Ui(e,t){return P(()=>{let r=new E;return r.subscribe({next({hidden:n}){e.hidden=n},complete(){e.hidden=!1}}),(Z("navigation.tabs.sticky")?I({hidden:!1}):js(e,t)).pipe(w(n=>r.next(n)),C(()=>r.complete()),m(n=>H({ref:e},n)))})}function Fs(e,{viewport$:t,header$:r}){let n=new Map,o=Q("[href^=\\#]",e);for(let a of o){let c=decodeURIComponent(a.hash.substring(1)),f=pe(`[id="${c}"]`);typeof f!="undefined"&&n.set(a,f)}let i=r.pipe(J("height"),m(({height:a})=>{let c=_e("main"),f=K(":scope > :first-child",c);return a+.8*(f.offsetTop-c.offsetTop)}),ie());return ve(document.body).pipe(J("height"),S(a=>P(()=>{let c=[];return I([...n].reduce((f,[u,p])=>{for(;c.length&&n.get(c[c.length-1]).tagName>=p.tagName;)c.pop();let l=p.offsetTop;for(;!l&&p.parentElement;)p=p.parentElement,l=p.offsetTop;return f.set([...c=[...c,u]].reverse(),l)},new Map))}).pipe(m(c=>new Map([...c].sort(([,f],[,u])=>f-u))),Ze(i),S(([c,f])=>t.pipe(Ur(([u,p],{offset:{y:l},size:d})=>{let h=l+d.height>=Math.floor(a.height);for(;p.length;){let[,b]=p[0];if(b-f=l&&!h)p=[u.pop(),...p];else break}return[u,p]},[[],[...c]]),B((u,p)=>u[0]===p[0]&&u[1]===p[1])))))).pipe(m(([a,c])=>({prev:a.map(([f])=>f),next:c.map(([f])=>f)})),N({prev:[],next:[]}),Ce(2,1),m(([a,c])=>a.prev.length{let o=new E,i=o.pipe(de(1));if(o.subscribe(({prev:s,next:a})=>{for(let[c]of a)c.classList.remove("md-nav__link--passed"),c.classList.remove("md-nav__link--active");for(let[c,[f]]of s.entries())f.classList.add("md-nav__link--passed"),f.classList.toggle("md-nav__link--active",c===s.length-1)}),Z("toc.follow")){let s=A(t.pipe(Re(1),m(()=>{})),t.pipe(Re(250),m(()=>"smooth")));o.pipe(x(({prev:a})=>a.length>0),ae(s)).subscribe(([{prev:a},c])=>{let[f]=a[a.length-1];if(f.offsetHeight){let u=cr(f);if(typeof u!="undefined"){let p=f.offsetTop-u.offsetTop,{height:l}=he(u);u.scrollTo({top:p-l/2,behavior:c})}}})}return Z("navigation.tracking")&&t.pipe(ee(i),J("offset"),Re(250),He(1),ee(n.pipe(He(1))),Tt({delay:250}),ae(o)).subscribe(([,{prev:s}])=>{let a=Oe(),c=s[s.length-1];if(c&&c.length){let[f]=c,{hash:u}=new URL(f.href);a.hash!==u&&(a.hash=u,history.replaceState({},"",`${a}`))}else a.hash="",history.replaceState({},"",`${a}`)}),Fs(e,{viewport$:t,header$:r}).pipe(w(s=>o.next(s)),C(()=>o.complete()),m(s=>H({ref:e},s)))})}function Us(e,{viewport$:t,main$:r,target$:n}){let o=t.pipe(m(({offset:{y:s}})=>s),Ce(2,1),m(([s,a])=>s>a&&a>0),B()),i=r.pipe(m(({active:s})=>s));return Y([i,o]).pipe(m(([s,a])=>!(s&&a)),B(),ee(n.pipe(He(1))),Fr(!0),Tt({delay:250}),m(s=>({hidden:s})))}function Wi(e,{viewport$:t,header$:r,main$:n,target$:o}){let i=new E,s=i.pipe(de(1));return i.subscribe({next({hidden:a}){e.hidden=a,a?(e.setAttribute("tabindex","-1"),e.blur()):e.removeAttribute("tabindex")},complete(){e.style.top="",e.hidden=!0,e.removeAttribute("tabindex")}}),r.pipe(ee(s),J("height")).subscribe(({height:a})=>{e.style.top=`${a+16}px`}),Us(e,{viewport$:t,main$:n,target$:o}).pipe(w(a=>i.next(a)),C(()=>i.complete()),m(a=>H({ref:e},a)))}function Vi({document$:e,tablet$:t}){e.pipe(S(()=>Q(".md-toggle--indeterminate, [data-md-state=indeterminate]")),w(r=>{r.indeterminate=!0,r.checked=!1}),se(r=>v(r,"change").pipe(Wr(()=>r.classList.contains("md-toggle--indeterminate")),m(()=>r))),ae(t)).subscribe(([r,n])=>{r.classList.remove("md-toggle--indeterminate"),n&&(r.checked=!1)})}function Ds(){return/(iPad|iPhone|iPod)/.test(navigator.userAgent)}function zi({document$:e}){e.pipe(S(()=>Q("[data-md-scrollfix]")),w(t=>t.removeAttribute("data-md-scrollfix")),x(Ds),se(t=>v(t,"touchstart").pipe(m(()=>t)))).subscribe(t=>{let r=t.scrollTop;r===0?t.scrollTop=1:r+t.offsetHeight===t.scrollHeight&&(t.scrollTop=r-1)})}function Ni({viewport$:e,tablet$:t}){Y([dt("search"),t]).pipe(m(([r,n])=>r&&!n),S(r=>I(r).pipe(ke(r?400:100))),ae(e)).subscribe(([r,{offset:{y:n}}])=>{if(r)document.body.setAttribute("data-md-scrolllock",""),document.body.style.top=`-${n}px`;else{let o=-1*parseInt(document.body.style.top,10);document.body.removeAttribute("data-md-scrolllock"),document.body.style.top="",o&&window.scrollTo(0,o)}})}Object.entries||(Object.entries=function(e){let t=[];for(let r of Object.keys(e))t.push([r,e[r]]);return t});Object.values||(Object.values=function(e){let t=[];for(let r of Object.keys(e))t.push(e[r]);return t});typeof Element!="undefined"&&(Element.prototype.scrollTo||(Element.prototype.scrollTo=function(e,t){typeof e=="object"?(this.scrollLeft=e.left,this.scrollTop=e.top):(this.scrollLeft=e,this.scrollTop=t)}),Element.prototype.replaceWith||(Element.prototype.replaceWith=function(...e){let t=this.parentNode;if(t){e.length===0&&t.removeChild(this);for(let r=e.length-1;r>=0;r--){let n=e[r];typeof n!="object"?n=document.createTextNode(n):n.parentNode&&n.parentNode.removeChild(n),r?t.insertBefore(this.previousSibling,n):t.replaceChild(n,this)}}}));document.documentElement.classList.remove("no-js");document.documentElement.classList.add("js");var tt=go(),vr=ko(),gt=jo(),on=Ro(),we=qo(),gr=Kr("(min-width: 960px)"),Ki=Kr("(min-width: 1220px)"),Qi=Fo(),Yi=le(),Bi=document.forms.namedItem("search")?(__search==null?void 0:__search.index)||je(new URL("search/search_index.json",Yi.base)):Se,an=new E;wi({alert$:an});Z("navigation.instant")&&Ei({document$:tt,location$:vr,viewport$:we});var qi;((qi=Yi.version)==null?void 0:qi.provider)==="mike"&&Li({document$:tt});A(vr,gt).pipe(ke(125)).subscribe(()=>{Ke("drawer",!1),Ke("search",!1)});on.pipe(x(({mode:e})=>e==="global")).subscribe(e=>{switch(e.type){case"p":case",":let t=pe("[href][rel=prev]");typeof t!="undefined"&&t.click();break;case"n":case".":let r=pe("[href][rel=next]");typeof r!="undefined"&&r.click();break}});Vi({document$:tt,tablet$:gr});zi({document$:tt});Ni({viewport$:we,tablet$:gr});var Qe=bi(_e("header"),{viewport$:we}),br=tt.pipe(m(()=>_e("main")),S(e=>yi(e,{viewport$:we,header$:Qe})),X(1)),Ws=A(...te("consent").map(e=>Yo(e,{target$:gt})),...te("dialog").map(e=>hi(e,{alert$:an})),...te("header").map(e=>vi(e,{viewport$:we,header$:Qe,main$:br})),...te("palette").map(e=>xi(e)),...te("search").map(e=>Hi(e,{index$:Bi,keyboard$:on})),...te("source").map(e=>Fi(e))),Vs=P(()=>A(...te("announce").map(e=>Qo(e)),...te("content").map(e=>di(e,{viewport$:we,target$:gt,print$:Qi})),...te("content").map(e=>Z("search.highlight")?Pi(e,{index$:Bi,location$:vr}):R),...te("header-title").map(e=>gi(e,{viewport$:we,header$:Qe})),...te("sidebar").map(e=>e.getAttribute("data-md-type")==="navigation"?Qr(Ki,()=>nn(e,{viewport$:we,header$:Qe,main$:br})):Qr(gr,()=>nn(e,{viewport$:we,header$:Qe,main$:br}))),...te("tabs").map(e=>Ui(e,{viewport$:we,header$:Qe})),...te("toc").map(e=>Di(e,{viewport$:we,header$:Qe,target$:gt})),...te("top").map(e=>Wi(e,{viewport$:we,header$:Qe,main$:br,target$:gt})))),Gi=tt.pipe(S(()=>Vs),et(Ws),X(1));Gi.subscribe();window.document$=tt;window.location$=vr;window.target$=gt;window.keyboard$=on;window.viewport$=we;window.tablet$=gr;window.screen$=Ki;window.print$=Qi;window.alert$=an;window.component$=Gi;})(); +//# sourceMappingURL=bundle.078830c0.min.js.map + diff --git a/assets/javascripts/bundle.078830c0.min.js.map b/assets/javascripts/bundle.078830c0.min.js.map new file mode 100644 index 00000000..36366697 --- /dev/null +++ b/assets/javascripts/bundle.078830c0.min.js.map @@ -0,0 +1,8 @@ +{ + "version": 3, + "sources": ["node_modules/focus-visible/dist/focus-visible.js", "node_modules/url-polyfill/url-polyfill.js", "node_modules/rxjs/node_modules/tslib/tslib.js", "node_modules/clipboard/dist/clipboard.js", "node_modules/escape-html/index.js", "node_modules/array-flat-polyfill/index.mjs", "src/assets/javascripts/bundle.ts", "node_modules/unfetch/polyfill/index.js", "node_modules/rxjs/node_modules/tslib/modules/index.js", "node_modules/rxjs/src/internal/util/isFunction.ts", "node_modules/rxjs/src/internal/util/createErrorClass.ts", "node_modules/rxjs/src/internal/util/UnsubscriptionError.ts", "node_modules/rxjs/src/internal/util/arrRemove.ts", "node_modules/rxjs/src/internal/Subscription.ts", "node_modules/rxjs/src/internal/config.ts", "node_modules/rxjs/src/internal/scheduler/timeoutProvider.ts", "node_modules/rxjs/src/internal/util/reportUnhandledError.ts", "node_modules/rxjs/src/internal/util/noop.ts", "node_modules/rxjs/src/internal/NotificationFactories.ts", "node_modules/rxjs/src/internal/util/errorContext.ts", "node_modules/rxjs/src/internal/Subscriber.ts", "node_modules/rxjs/src/internal/symbol/observable.ts", "node_modules/rxjs/src/internal/util/identity.ts", "node_modules/rxjs/src/internal/util/pipe.ts", "node_modules/rxjs/src/internal/Observable.ts", "node_modules/rxjs/src/internal/util/lift.ts", "node_modules/rxjs/src/internal/operators/OperatorSubscriber.ts", "node_modules/rxjs/src/internal/scheduler/animationFrameProvider.ts", "node_modules/rxjs/src/internal/util/ObjectUnsubscribedError.ts", "node_modules/rxjs/src/internal/Subject.ts", "node_modules/rxjs/src/internal/scheduler/dateTimestampProvider.ts", "node_modules/rxjs/src/internal/ReplaySubject.ts", "node_modules/rxjs/src/internal/scheduler/Action.ts", "node_modules/rxjs/src/internal/scheduler/intervalProvider.ts", "node_modules/rxjs/src/internal/scheduler/AsyncAction.ts", "node_modules/rxjs/src/internal/Scheduler.ts", "node_modules/rxjs/src/internal/scheduler/AsyncScheduler.ts", "node_modules/rxjs/src/internal/scheduler/async.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameAction.ts", "node_modules/rxjs/src/internal/scheduler/AnimationFrameScheduler.ts", "node_modules/rxjs/src/internal/scheduler/animationFrame.ts", "node_modules/rxjs/src/internal/observable/empty.ts", "node_modules/rxjs/src/internal/util/isScheduler.ts", "node_modules/rxjs/src/internal/util/args.ts", "node_modules/rxjs/src/internal/util/isArrayLike.ts", "node_modules/rxjs/src/internal/util/isPromise.ts", "node_modules/rxjs/src/internal/util/isInteropObservable.ts", "node_modules/rxjs/src/internal/util/isAsyncIterable.ts", "node_modules/rxjs/src/internal/util/throwUnobservableError.ts", "node_modules/rxjs/src/internal/symbol/iterator.ts", "node_modules/rxjs/src/internal/util/isIterable.ts", "node_modules/rxjs/src/internal/util/isReadableStreamLike.ts", "node_modules/rxjs/src/internal/observable/innerFrom.ts", "node_modules/rxjs/src/internal/util/executeSchedule.ts", "node_modules/rxjs/src/internal/operators/observeOn.ts", "node_modules/rxjs/src/internal/operators/subscribeOn.ts", "node_modules/rxjs/src/internal/scheduled/scheduleObservable.ts", "node_modules/rxjs/src/internal/scheduled/schedulePromise.ts", "node_modules/rxjs/src/internal/scheduled/scheduleArray.ts", "node_modules/rxjs/src/internal/scheduled/scheduleIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleAsyncIterable.ts", "node_modules/rxjs/src/internal/scheduled/scheduleReadableStreamLike.ts", "node_modules/rxjs/src/internal/scheduled/scheduled.ts", "node_modules/rxjs/src/internal/observable/from.ts", "node_modules/rxjs/src/internal/observable/of.ts", "node_modules/rxjs/src/internal/observable/throwError.ts", "node_modules/rxjs/src/internal/util/isDate.ts", "node_modules/rxjs/src/internal/operators/map.ts", "node_modules/rxjs/src/internal/util/mapOneOrManyArgs.ts", "node_modules/rxjs/src/internal/util/argsArgArrayOrObject.ts", "node_modules/rxjs/src/internal/util/createObject.ts", "node_modules/rxjs/src/internal/observable/combineLatest.ts", "node_modules/rxjs/src/internal/operators/mergeInternals.ts", "node_modules/rxjs/src/internal/operators/mergeMap.ts", "node_modules/rxjs/src/internal/operators/mergeAll.ts", "node_modules/rxjs/src/internal/operators/concatAll.ts", "node_modules/rxjs/src/internal/observable/concat.ts", "node_modules/rxjs/src/internal/observable/defer.ts", "node_modules/rxjs/src/internal/observable/fromEvent.ts", "node_modules/rxjs/src/internal/observable/fromEventPattern.ts", "node_modules/rxjs/src/internal/observable/timer.ts", "node_modules/rxjs/src/internal/observable/merge.ts", "node_modules/rxjs/src/internal/observable/never.ts", "node_modules/rxjs/src/internal/util/argsOrArgArray.ts", "node_modules/rxjs/src/internal/operators/filter.ts", "node_modules/rxjs/src/internal/observable/zip.ts", "node_modules/rxjs/src/internal/operators/audit.ts", "node_modules/rxjs/src/internal/operators/auditTime.ts", "node_modules/rxjs/src/internal/operators/bufferCount.ts", "node_modules/rxjs/src/internal/operators/catchError.ts", "node_modules/rxjs/src/internal/operators/scanInternals.ts", "node_modules/rxjs/src/internal/operators/combineLatest.ts", "node_modules/rxjs/src/internal/operators/combineLatestWith.ts", "node_modules/rxjs/src/internal/operators/concatMap.ts", "node_modules/rxjs/src/internal/operators/debounceTime.ts", "node_modules/rxjs/src/internal/operators/defaultIfEmpty.ts", "node_modules/rxjs/src/internal/operators/take.ts", "node_modules/rxjs/src/internal/operators/ignoreElements.ts", "node_modules/rxjs/src/internal/operators/mapTo.ts", "node_modules/rxjs/src/internal/operators/delayWhen.ts", "node_modules/rxjs/src/internal/operators/delay.ts", "node_modules/rxjs/src/internal/operators/distinctUntilChanged.ts", "node_modules/rxjs/src/internal/operators/distinctUntilKeyChanged.ts", "node_modules/rxjs/src/internal/operators/endWith.ts", "node_modules/rxjs/src/internal/operators/finalize.ts", "node_modules/rxjs/src/internal/operators/takeLast.ts", "node_modules/rxjs/src/internal/operators/merge.ts", "node_modules/rxjs/src/internal/operators/mergeWith.ts", "node_modules/rxjs/src/internal/operators/repeat.ts", "node_modules/rxjs/src/internal/operators/sample.ts", "node_modules/rxjs/src/internal/operators/scan.ts", "node_modules/rxjs/src/internal/operators/share.ts", "node_modules/rxjs/src/internal/operators/shareReplay.ts", "node_modules/rxjs/src/internal/operators/skip.ts", "node_modules/rxjs/src/internal/operators/skipUntil.ts", "node_modules/rxjs/src/internal/operators/startWith.ts", "node_modules/rxjs/src/internal/operators/switchMap.ts", "node_modules/rxjs/src/internal/operators/takeUntil.ts", "node_modules/rxjs/src/internal/operators/takeWhile.ts", "node_modules/rxjs/src/internal/operators/tap.ts", "node_modules/rxjs/src/internal/operators/throttle.ts", "node_modules/rxjs/src/internal/operators/throttleTime.ts", "node_modules/rxjs/src/internal/operators/withLatestFrom.ts", "node_modules/rxjs/src/internal/operators/zip.ts", "node_modules/rxjs/src/internal/operators/zipWith.ts", "src/assets/javascripts/browser/document/index.ts", "src/assets/javascripts/browser/element/_/index.ts", "src/assets/javascripts/browser/element/focus/index.ts", "src/assets/javascripts/browser/element/offset/_/index.ts", "src/assets/javascripts/browser/element/offset/content/index.ts", "node_modules/resize-observer-polyfill/dist/ResizeObserver.es.js", "src/assets/javascripts/browser/element/size/_/index.ts", "src/assets/javascripts/browser/element/size/content/index.ts", "src/assets/javascripts/browser/element/visibility/index.ts", "src/assets/javascripts/browser/toggle/index.ts", "src/assets/javascripts/browser/keyboard/index.ts", "src/assets/javascripts/browser/location/_/index.ts", "src/assets/javascripts/utilities/h/index.ts", "src/assets/javascripts/utilities/string/index.ts", "src/assets/javascripts/browser/location/hash/index.ts", "src/assets/javascripts/browser/media/index.ts", "src/assets/javascripts/browser/request/index.ts", "src/assets/javascripts/browser/script/index.ts", "src/assets/javascripts/browser/viewport/offset/index.ts", "src/assets/javascripts/browser/viewport/size/index.ts", "src/assets/javascripts/browser/viewport/_/index.ts", "src/assets/javascripts/browser/viewport/at/index.ts", "src/assets/javascripts/browser/worker/index.ts", "src/assets/javascripts/_/index.ts", "src/assets/javascripts/components/_/index.ts", "src/assets/javascripts/components/announce/index.ts", "src/assets/javascripts/components/consent/index.ts", "src/assets/javascripts/components/content/code/_/index.ts", "src/assets/javascripts/templates/tooltip/index.tsx", "src/assets/javascripts/templates/annotation/index.tsx", "src/assets/javascripts/templates/clipboard/index.tsx", "src/assets/javascripts/templates/search/index.tsx", "src/assets/javascripts/templates/source/index.tsx", "src/assets/javascripts/templates/tabbed/index.tsx", "src/assets/javascripts/templates/table/index.tsx", "src/assets/javascripts/templates/version/index.tsx", "src/assets/javascripts/components/content/annotation/_/index.ts", "src/assets/javascripts/components/content/annotation/list/index.ts", "src/assets/javascripts/components/content/code/mermaid/index.ts", "src/assets/javascripts/components/content/details/index.ts", "src/assets/javascripts/components/content/table/index.ts", "src/assets/javascripts/components/content/tabs/index.ts", "src/assets/javascripts/components/content/_/index.ts", "src/assets/javascripts/components/dialog/index.ts", "src/assets/javascripts/components/header/_/index.ts", "src/assets/javascripts/components/header/title/index.ts", "src/assets/javascripts/components/main/index.ts", "src/assets/javascripts/components/palette/index.ts", "src/assets/javascripts/integrations/clipboard/index.ts", "src/assets/javascripts/integrations/sitemap/index.ts", "src/assets/javascripts/integrations/instant/index.ts", "src/assets/javascripts/integrations/search/document/index.ts", "src/assets/javascripts/integrations/search/highlighter/index.ts", "src/assets/javascripts/integrations/search/query/transform/index.ts", "src/assets/javascripts/integrations/search/worker/message/index.ts", "src/assets/javascripts/integrations/search/worker/_/index.ts", "src/assets/javascripts/integrations/version/index.ts", "src/assets/javascripts/components/search/query/index.ts", "src/assets/javascripts/components/search/result/index.ts", "src/assets/javascripts/components/search/share/index.ts", "src/assets/javascripts/components/search/suggest/index.ts", "src/assets/javascripts/components/search/_/index.ts", "src/assets/javascripts/components/search/highlight/index.ts", "src/assets/javascripts/components/sidebar/index.ts", "src/assets/javascripts/components/source/facts/github/index.ts", "src/assets/javascripts/components/source/facts/gitlab/index.ts", "src/assets/javascripts/components/source/facts/_/index.ts", "src/assets/javascripts/components/source/_/index.ts", "src/assets/javascripts/components/tabs/index.ts", "src/assets/javascripts/components/toc/index.ts", "src/assets/javascripts/components/top/index.ts", "src/assets/javascripts/patches/indeterminate/index.ts", "src/assets/javascripts/patches/scrollfix/index.ts", "src/assets/javascripts/patches/scrolllock/index.ts", "src/assets/javascripts/polyfills/index.ts"], + "sourceRoot": "../../../..", + "sourcesContent": ["(function (global, factory) {\n typeof exports === 'object' && typeof module !== 'undefined' ? factory() :\n typeof define === 'function' && define.amd ? define(factory) :\n (factory());\n}(this, (function () { 'use strict';\n\n /**\n * Applies the :focus-visible polyfill at the given scope.\n * A scope in this case is either the top-level Document or a Shadow Root.\n *\n * @param {(Document|ShadowRoot)} scope\n * @see https://github.com/WICG/focus-visible\n */\n function applyFocusVisiblePolyfill(scope) {\n var hadKeyboardEvent = true;\n var hadFocusVisibleRecently = false;\n var hadFocusVisibleRecentlyTimeout = null;\n\n var inputTypesAllowlist = {\n text: true,\n search: true,\n url: true,\n tel: true,\n email: true,\n password: true,\n number: true,\n date: true,\n month: true,\n week: true,\n time: true,\n datetime: true,\n 'datetime-local': true\n };\n\n /**\n * Helper function for legacy browsers and iframes which sometimes focus\n * elements like document, body, and non-interactive SVG.\n * @param {Element} el\n */\n function isValidFocusTarget(el) {\n if (\n el &&\n el !== document &&\n el.nodeName !== 'HTML' &&\n el.nodeName !== 'BODY' &&\n 'classList' in el &&\n 'contains' in el.classList\n ) {\n return true;\n }\n return false;\n }\n\n /**\n * Computes whether the given element should automatically trigger the\n * `focus-visible` class being added, i.e. whether it should always match\n * `:focus-visible` when focused.\n * @param {Element} el\n * @return {boolean}\n */\n function focusTriggersKeyboardModality(el) {\n var type = el.type;\n var tagName = el.tagName;\n\n if (tagName === 'INPUT' && inputTypesAllowlist[type] && !el.readOnly) {\n return true;\n }\n\n if (tagName === 'TEXTAREA' && !el.readOnly) {\n return true;\n }\n\n if (el.isContentEditable) {\n return true;\n }\n\n return false;\n }\n\n /**\n * Add the `focus-visible` class to the given element if it was not added by\n * the author.\n * @param {Element} el\n */\n function addFocusVisibleClass(el) {\n if (el.classList.contains('focus-visible')) {\n return;\n }\n el.classList.add('focus-visible');\n el.setAttribute('data-focus-visible-added', '');\n }\n\n /**\n * Remove the `focus-visible` class from the given element if it was not\n * originally added by the author.\n * @param {Element} el\n */\n function removeFocusVisibleClass(el) {\n if (!el.hasAttribute('data-focus-visible-added')) {\n return;\n }\n el.classList.remove('focus-visible');\n el.removeAttribute('data-focus-visible-added');\n }\n\n /**\n * If the most recent user interaction was via the keyboard;\n * and the key press did not include a meta, alt/option, or control key;\n * then the modality is keyboard. Otherwise, the modality is not keyboard.\n * Apply `focus-visible` to any current active element and keep track\n * of our keyboard modality state with `hadKeyboardEvent`.\n * @param {KeyboardEvent} e\n */\n function onKeyDown(e) {\n if (e.metaKey || e.altKey || e.ctrlKey) {\n return;\n }\n\n if (isValidFocusTarget(scope.activeElement)) {\n addFocusVisibleClass(scope.activeElement);\n }\n\n hadKeyboardEvent = true;\n }\n\n /**\n * If at any point a user clicks with a pointing device, ensure that we change\n * the modality away from keyboard.\n * This avoids the situation where a user presses a key on an already focused\n * element, and then clicks on a different element, focusing it with a\n * pointing device, while we still think we're in keyboard modality.\n * @param {Event} e\n */\n function onPointerDown(e) {\n hadKeyboardEvent = false;\n }\n\n /**\n * On `focus`, add the `focus-visible` class to the target if:\n * - the target received focus as a result of keyboard navigation, or\n * - the event target is an element that will likely require interaction\n * via the keyboard (e.g. a text box)\n * @param {Event} e\n */\n function onFocus(e) {\n // Prevent IE from focusing the document or HTML element.\n if (!isValidFocusTarget(e.target)) {\n return;\n }\n\n if (hadKeyboardEvent || focusTriggersKeyboardModality(e.target)) {\n addFocusVisibleClass(e.target);\n }\n }\n\n /**\n * On `blur`, remove the `focus-visible` class from the target.\n * @param {Event} e\n */\n function onBlur(e) {\n if (!isValidFocusTarget(e.target)) {\n return;\n }\n\n if (\n e.target.classList.contains('focus-visible') ||\n e.target.hasAttribute('data-focus-visible-added')\n ) {\n // To detect a tab/window switch, we look for a blur event followed\n // rapidly by a visibility change.\n // If we don't see a visibility change within 100ms, it's probably a\n // regular focus change.\n hadFocusVisibleRecently = true;\n window.clearTimeout(hadFocusVisibleRecentlyTimeout);\n hadFocusVisibleRecentlyTimeout = window.setTimeout(function() {\n hadFocusVisibleRecently = false;\n }, 100);\n removeFocusVisibleClass(e.target);\n }\n }\n\n /**\n * If the user changes tabs, keep track of whether or not the previously\n * focused element had .focus-visible.\n * @param {Event} e\n */\n function onVisibilityChange(e) {\n if (document.visibilityState === 'hidden') {\n // If the tab becomes active again, the browser will handle calling focus\n // on the element (Safari actually calls it twice).\n // If this tab change caused a blur on an element with focus-visible,\n // re-apply the class when the user switches back to the tab.\n if (hadFocusVisibleRecently) {\n hadKeyboardEvent = true;\n }\n addInitialPointerMoveListeners();\n }\n }\n\n /**\n * Add a group of listeners to detect usage of any pointing devices.\n * These listeners will be added when the polyfill first loads, and anytime\n * the window is blurred, so that they are active when the window regains\n * focus.\n */\n function addInitialPointerMoveListeners() {\n document.addEventListener('mousemove', onInitialPointerMove);\n document.addEventListener('mousedown', onInitialPointerMove);\n document.addEventListener('mouseup', onInitialPointerMove);\n document.addEventListener('pointermove', onInitialPointerMove);\n document.addEventListener('pointerdown', onInitialPointerMove);\n document.addEventListener('pointerup', onInitialPointerMove);\n document.addEventListener('touchmove', onInitialPointerMove);\n document.addEventListener('touchstart', onInitialPointerMove);\n document.addEventListener('touchend', onInitialPointerMove);\n }\n\n function removeInitialPointerMoveListeners() {\n document.removeEventListener('mousemove', onInitialPointerMove);\n document.removeEventListener('mousedown', onInitialPointerMove);\n document.removeEventListener('mouseup', onInitialPointerMove);\n document.removeEventListener('pointermove', onInitialPointerMove);\n document.removeEventListener('pointerdown', onInitialPointerMove);\n document.removeEventListener('pointerup', onInitialPointerMove);\n document.removeEventListener('touchmove', onInitialPointerMove);\n document.removeEventListener('touchstart', onInitialPointerMove);\n document.removeEventListener('touchend', onInitialPointerMove);\n }\n\n /**\n * When the polfyill first loads, assume the user is in keyboard modality.\n * If any event is received from a pointing device (e.g. mouse, pointer,\n * touch), turn off keyboard modality.\n * This accounts for situations where focus enters the page from the URL bar.\n * @param {Event} e\n */\n function onInitialPointerMove(e) {\n // Work around a Safari quirk that fires a mousemove on whenever the\n // window blurs, even if you're tabbing out of the page. \u00AF\\_(\u30C4)_/\u00AF\n if (e.target.nodeName && e.target.nodeName.toLowerCase() === 'html') {\n return;\n }\n\n hadKeyboardEvent = false;\n removeInitialPointerMoveListeners();\n }\n\n // For some kinds of state, we are interested in changes at the global scope\n // only. For example, global pointer input, global key presses and global\n // visibility change should affect the state at every scope:\n document.addEventListener('keydown', onKeyDown, true);\n document.addEventListener('mousedown', onPointerDown, true);\n document.addEventListener('pointerdown', onPointerDown, true);\n document.addEventListener('touchstart', onPointerDown, true);\n document.addEventListener('visibilitychange', onVisibilityChange, true);\n\n addInitialPointerMoveListeners();\n\n // For focus and blur, we specifically care about state changes in the local\n // scope. This is because focus / blur events that originate from within a\n // shadow root are not re-dispatched from the host element if it was already\n // the active element in its own scope:\n scope.addEventListener('focus', onFocus, true);\n scope.addEventListener('blur', onBlur, true);\n\n // We detect that a node is a ShadowRoot by ensuring that it is a\n // DocumentFragment and also has a host property. This check covers native\n // implementation and polyfill implementation transparently. If we only cared\n // about the native implementation, we could just check if the scope was\n // an instance of a ShadowRoot.\n if (scope.nodeType === Node.DOCUMENT_FRAGMENT_NODE && scope.host) {\n // Since a ShadowRoot is a special kind of DocumentFragment, it does not\n // have a root element to add a class to. So, we add this attribute to the\n // host element instead:\n scope.host.setAttribute('data-js-focus-visible', '');\n } else if (scope.nodeType === Node.DOCUMENT_NODE) {\n document.documentElement.classList.add('js-focus-visible');\n document.documentElement.setAttribute('data-js-focus-visible', '');\n }\n }\n\n // It is important to wrap all references to global window and document in\n // these checks to support server-side rendering use cases\n // @see https://github.com/WICG/focus-visible/issues/199\n if (typeof window !== 'undefined' && typeof document !== 'undefined') {\n // Make the polyfill helper globally available. This can be used as a signal\n // to interested libraries that wish to coordinate with the polyfill for e.g.,\n // applying the polyfill to a shadow root:\n window.applyFocusVisiblePolyfill = applyFocusVisiblePolyfill;\n\n // Notify interested libraries of the polyfill's presence, in case the\n // polyfill was loaded lazily:\n var event;\n\n try {\n event = new CustomEvent('focus-visible-polyfill-ready');\n } catch (error) {\n // IE11 does not support using CustomEvent as a constructor directly:\n event = document.createEvent('CustomEvent');\n event.initCustomEvent('focus-visible-polyfill-ready', false, false, {});\n }\n\n window.dispatchEvent(event);\n }\n\n if (typeof document !== 'undefined') {\n // Apply the polyfill to the global document, so that no JavaScript\n // coordination is required to use the polyfill in the top-level document:\n applyFocusVisiblePolyfill(document);\n }\n\n})));\n", "(function(global) {\r\n /**\r\n * Polyfill URLSearchParams\r\n *\r\n * Inspired from : https://github.com/WebReflection/url-search-params/blob/master/src/url-search-params.js\r\n */\r\n\r\n var checkIfIteratorIsSupported = function() {\r\n try {\r\n return !!Symbol.iterator;\r\n } catch (error) {\r\n return false;\r\n }\r\n };\r\n\r\n\r\n var iteratorSupported = checkIfIteratorIsSupported();\r\n\r\n var createIterator = function(items) {\r\n var iterator = {\r\n next: function() {\r\n var value = items.shift();\r\n return { done: value === void 0, value: value };\r\n }\r\n };\r\n\r\n if (iteratorSupported) {\r\n iterator[Symbol.iterator] = function() {\r\n return iterator;\r\n };\r\n }\r\n\r\n return iterator;\r\n };\r\n\r\n /**\r\n * Search param name and values should be encoded according to https://url.spec.whatwg.org/#urlencoded-serializing\r\n * encodeURIComponent() produces the same result except encoding spaces as `%20` instead of `+`.\r\n */\r\n var serializeParam = function(value) {\r\n return encodeURIComponent(value).replace(/%20/g, '+');\r\n };\r\n\r\n var deserializeParam = function(value) {\r\n return decodeURIComponent(String(value).replace(/\\+/g, ' '));\r\n };\r\n\r\n var polyfillURLSearchParams = function() {\r\n\r\n var URLSearchParams = function(searchString) {\r\n Object.defineProperty(this, '_entries', { writable: true, value: {} });\r\n var typeofSearchString = typeof searchString;\r\n\r\n if (typeofSearchString === 'undefined') {\r\n // do nothing\r\n } else if (typeofSearchString === 'string') {\r\n if (searchString !== '') {\r\n this._fromString(searchString);\r\n }\r\n } else if (searchString instanceof URLSearchParams) {\r\n var _this = this;\r\n searchString.forEach(function(value, name) {\r\n _this.append(name, value);\r\n });\r\n } else if ((searchString !== null) && (typeofSearchString === 'object')) {\r\n if (Object.prototype.toString.call(searchString) === '[object Array]') {\r\n for (var i = 0; i < searchString.length; i++) {\r\n var entry = searchString[i];\r\n if ((Object.prototype.toString.call(entry) === '[object Array]') || (entry.length !== 2)) {\r\n this.append(entry[0], entry[1]);\r\n } else {\r\n throw new TypeError('Expected [string, any] as entry at index ' + i + ' of URLSearchParams\\'s input');\r\n }\r\n }\r\n } else {\r\n for (var key in searchString) {\r\n if (searchString.hasOwnProperty(key)) {\r\n this.append(key, searchString[key]);\r\n }\r\n }\r\n }\r\n } else {\r\n throw new TypeError('Unsupported input\\'s type for URLSearchParams');\r\n }\r\n };\r\n\r\n var proto = URLSearchParams.prototype;\r\n\r\n proto.append = function(name, value) {\r\n if (name in this._entries) {\r\n this._entries[name].push(String(value));\r\n } else {\r\n this._entries[name] = [String(value)];\r\n }\r\n };\r\n\r\n proto.delete = function(name) {\r\n delete this._entries[name];\r\n };\r\n\r\n proto.get = function(name) {\r\n return (name in this._entries) ? this._entries[name][0] : null;\r\n };\r\n\r\n proto.getAll = function(name) {\r\n return (name in this._entries) ? this._entries[name].slice(0) : [];\r\n };\r\n\r\n proto.has = function(name) {\r\n return (name in this._entries);\r\n };\r\n\r\n proto.set = function(name, value) {\r\n this._entries[name] = [String(value)];\r\n };\r\n\r\n proto.forEach = function(callback, thisArg) {\r\n var entries;\r\n for (var name in this._entries) {\r\n if (this._entries.hasOwnProperty(name)) {\r\n entries = this._entries[name];\r\n for (var i = 0; i < entries.length; i++) {\r\n callback.call(thisArg, entries[i], name, this);\r\n }\r\n }\r\n }\r\n };\r\n\r\n proto.keys = function() {\r\n var items = [];\r\n this.forEach(function(value, name) {\r\n items.push(name);\r\n });\r\n return createIterator(items);\r\n };\r\n\r\n proto.values = function() {\r\n var items = [];\r\n this.forEach(function(value) {\r\n items.push(value);\r\n });\r\n return createIterator(items);\r\n };\r\n\r\n proto.entries = function() {\r\n var items = [];\r\n this.forEach(function(value, name) {\r\n items.push([name, value]);\r\n });\r\n return createIterator(items);\r\n };\r\n\r\n if (iteratorSupported) {\r\n proto[Symbol.iterator] = proto.entries;\r\n }\r\n\r\n proto.toString = function() {\r\n var searchArray = [];\r\n this.forEach(function(value, name) {\r\n searchArray.push(serializeParam(name) + '=' + serializeParam(value));\r\n });\r\n return searchArray.join('&');\r\n };\r\n\r\n\r\n global.URLSearchParams = URLSearchParams;\r\n };\r\n\r\n var checkIfURLSearchParamsSupported = function() {\r\n try {\r\n var URLSearchParams = global.URLSearchParams;\r\n\r\n return (\r\n (new URLSearchParams('?a=1').toString() === 'a=1') &&\r\n (typeof URLSearchParams.prototype.set === 'function') &&\r\n (typeof URLSearchParams.prototype.entries === 'function')\r\n );\r\n } catch (e) {\r\n return false;\r\n }\r\n };\r\n\r\n if (!checkIfURLSearchParamsSupported()) {\r\n polyfillURLSearchParams();\r\n }\r\n\r\n var proto = global.URLSearchParams.prototype;\r\n\r\n if (typeof proto.sort !== 'function') {\r\n proto.sort = function() {\r\n var _this = this;\r\n var items = [];\r\n this.forEach(function(value, name) {\r\n items.push([name, value]);\r\n if (!_this._entries) {\r\n _this.delete(name);\r\n }\r\n });\r\n items.sort(function(a, b) {\r\n if (a[0] < b[0]) {\r\n return -1;\r\n } else if (a[0] > b[0]) {\r\n return +1;\r\n } else {\r\n return 0;\r\n }\r\n });\r\n if (_this._entries) { // force reset because IE keeps keys index\r\n _this._entries = {};\r\n }\r\n for (var i = 0; i < items.length; i++) {\r\n this.append(items[i][0], items[i][1]);\r\n }\r\n };\r\n }\r\n\r\n if (typeof proto._fromString !== 'function') {\r\n Object.defineProperty(proto, '_fromString', {\r\n enumerable: false,\r\n configurable: false,\r\n writable: false,\r\n value: function(searchString) {\r\n if (this._entries) {\r\n this._entries = {};\r\n } else {\r\n var keys = [];\r\n this.forEach(function(value, name) {\r\n keys.push(name);\r\n });\r\n for (var i = 0; i < keys.length; i++) {\r\n this.delete(keys[i]);\r\n }\r\n }\r\n\r\n searchString = searchString.replace(/^\\?/, '');\r\n var attributes = searchString.split('&');\r\n var attribute;\r\n for (var i = 0; i < attributes.length; i++) {\r\n attribute = attributes[i].split('=');\r\n this.append(\r\n deserializeParam(attribute[0]),\r\n (attribute.length > 1) ? deserializeParam(attribute[1]) : ''\r\n );\r\n }\r\n }\r\n });\r\n }\r\n\r\n // HTMLAnchorElement\r\n\r\n})(\r\n (typeof global !== 'undefined') ? global\r\n : ((typeof window !== 'undefined') ? window\r\n : ((typeof self !== 'undefined') ? self : this))\r\n);\r\n\r\n(function(global) {\r\n /**\r\n * Polyfill URL\r\n *\r\n * Inspired from : https://github.com/arv/DOM-URL-Polyfill/blob/master/src/url.js\r\n */\r\n\r\n var checkIfURLIsSupported = function() {\r\n try {\r\n var u = new global.URL('b', 'http://a');\r\n u.pathname = 'c d';\r\n return (u.href === 'http://a/c%20d') && u.searchParams;\r\n } catch (e) {\r\n return false;\r\n }\r\n };\r\n\r\n\r\n var polyfillURL = function() {\r\n var _URL = global.URL;\r\n\r\n var URL = function(url, base) {\r\n if (typeof url !== 'string') url = String(url);\r\n if (base && typeof base !== 'string') base = String(base);\r\n\r\n // Only create another document if the base is different from current location.\r\n var doc = document, baseElement;\r\n if (base && (global.location === void 0 || base !== global.location.href)) {\r\n base = base.toLowerCase();\r\n doc = document.implementation.createHTMLDocument('');\r\n baseElement = doc.createElement('base');\r\n baseElement.href = base;\r\n doc.head.appendChild(baseElement);\r\n try {\r\n if (baseElement.href.indexOf(base) !== 0) throw new Error(baseElement.href);\r\n } catch (err) {\r\n throw new Error('URL unable to set base ' + base + ' due to ' + err);\r\n }\r\n }\r\n\r\n var anchorElement = doc.createElement('a');\r\n anchorElement.href = url;\r\n if (baseElement) {\r\n doc.body.appendChild(anchorElement);\r\n anchorElement.href = anchorElement.href; // force href to refresh\r\n }\r\n\r\n var inputElement = doc.createElement('input');\r\n inputElement.type = 'url';\r\n inputElement.value = url;\r\n\r\n if (anchorElement.protocol === ':' || !/:/.test(anchorElement.href) || (!inputElement.checkValidity() && !base)) {\r\n throw new TypeError('Invalid URL');\r\n }\r\n\r\n Object.defineProperty(this, '_anchorElement', {\r\n value: anchorElement\r\n });\r\n\r\n\r\n // create a linked searchParams which reflect its changes on URL\r\n var searchParams = new global.URLSearchParams(this.search);\r\n var enableSearchUpdate = true;\r\n var enableSearchParamsUpdate = true;\r\n var _this = this;\r\n ['append', 'delete', 'set'].forEach(function(methodName) {\r\n var method = searchParams[methodName];\r\n searchParams[methodName] = function() {\r\n method.apply(searchParams, arguments);\r\n if (enableSearchUpdate) {\r\n enableSearchParamsUpdate = false;\r\n _this.search = searchParams.toString();\r\n enableSearchParamsUpdate = true;\r\n }\r\n };\r\n });\r\n\r\n Object.defineProperty(this, 'searchParams', {\r\n value: searchParams,\r\n enumerable: true\r\n });\r\n\r\n var search = void 0;\r\n Object.defineProperty(this, '_updateSearchParams', {\r\n enumerable: false,\r\n configurable: false,\r\n writable: false,\r\n value: function() {\r\n if (this.search !== search) {\r\n search = this.search;\r\n if (enableSearchParamsUpdate) {\r\n enableSearchUpdate = false;\r\n this.searchParams._fromString(this.search);\r\n enableSearchUpdate = true;\r\n }\r\n }\r\n }\r\n });\r\n };\r\n\r\n var proto = URL.prototype;\r\n\r\n var linkURLWithAnchorAttribute = function(attributeName) {\r\n Object.defineProperty(proto, attributeName, {\r\n get: function() {\r\n return this._anchorElement[attributeName];\r\n },\r\n set: function(value) {\r\n this._anchorElement[attributeName] = value;\r\n },\r\n enumerable: true\r\n });\r\n };\r\n\r\n ['hash', 'host', 'hostname', 'port', 'protocol']\r\n .forEach(function(attributeName) {\r\n linkURLWithAnchorAttribute(attributeName);\r\n });\r\n\r\n Object.defineProperty(proto, 'search', {\r\n get: function() {\r\n return this._anchorElement['search'];\r\n },\r\n set: function(value) {\r\n this._anchorElement['search'] = value;\r\n this._updateSearchParams();\r\n },\r\n enumerable: true\r\n });\r\n\r\n Object.defineProperties(proto, {\r\n\r\n 'toString': {\r\n get: function() {\r\n var _this = this;\r\n return function() {\r\n return _this.href;\r\n };\r\n }\r\n },\r\n\r\n 'href': {\r\n get: function() {\r\n return this._anchorElement.href.replace(/\\?$/, '');\r\n },\r\n set: function(value) {\r\n this._anchorElement.href = value;\r\n this._updateSearchParams();\r\n },\r\n enumerable: true\r\n },\r\n\r\n 'pathname': {\r\n get: function() {\r\n return this._anchorElement.pathname.replace(/(^\\/?)/, '/');\r\n },\r\n set: function(value) {\r\n this._anchorElement.pathname = value;\r\n },\r\n enumerable: true\r\n },\r\n\r\n 'origin': {\r\n get: function() {\r\n // get expected port from protocol\r\n var expectedPort = { 'http:': 80, 'https:': 443, 'ftp:': 21 }[this._anchorElement.protocol];\r\n // add port to origin if, expected port is different than actual port\r\n // and it is not empty f.e http://foo:8080\r\n // 8080 != 80 && 8080 != ''\r\n var addPortToOrigin = this._anchorElement.port != expectedPort &&\r\n this._anchorElement.port !== '';\r\n\r\n return this._anchorElement.protocol +\r\n '//' +\r\n this._anchorElement.hostname +\r\n (addPortToOrigin ? (':' + this._anchorElement.port) : '');\r\n },\r\n enumerable: true\r\n },\r\n\r\n 'password': { // TODO\r\n get: function() {\r\n return '';\r\n },\r\n set: function(value) {\r\n },\r\n enumerable: true\r\n },\r\n\r\n 'username': { // TODO\r\n get: function() {\r\n return '';\r\n },\r\n set: function(value) {\r\n },\r\n enumerable: true\r\n },\r\n });\r\n\r\n URL.createObjectURL = function(blob) {\r\n return _URL.createObjectURL.apply(_URL, arguments);\r\n };\r\n\r\n URL.revokeObjectURL = function(url) {\r\n return _URL.revokeObjectURL.apply(_URL, arguments);\r\n };\r\n\r\n global.URL = URL;\r\n\r\n };\r\n\r\n if (!checkIfURLIsSupported()) {\r\n polyfillURL();\r\n }\r\n\r\n if ((global.location !== void 0) && !('origin' in global.location)) {\r\n var getOrigin = function() {\r\n return global.location.protocol + '//' + global.location.hostname + (global.location.port ? (':' + global.location.port) : '');\r\n };\r\n\r\n try {\r\n Object.defineProperty(global.location, 'origin', {\r\n get: getOrigin,\r\n enumerable: true\r\n });\r\n } catch (e) {\r\n setInterval(function() {\r\n global.location.origin = getOrigin();\r\n }, 100);\r\n }\r\n }\r\n\r\n})(\r\n (typeof global !== 'undefined') ? global\r\n : ((typeof window !== 'undefined') ? window\r\n : ((typeof self !== 'undefined') ? self : this))\r\n);\r\n", "/*! *****************************************************************************\r\nCopyright (c) Microsoft Corporation.\r\n\r\nPermission to use, copy, modify, and/or distribute this software for any\r\npurpose with or without fee is hereby granted.\r\n\r\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH\r\nREGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY\r\nAND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,\r\nINDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM\r\nLOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR\r\nOTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR\r\nPERFORMANCE OF THIS SOFTWARE.\r\n***************************************************************************** */\r\n/* global global, define, System, Reflect, Promise */\r\nvar __extends;\r\nvar __assign;\r\nvar __rest;\r\nvar __decorate;\r\nvar __param;\r\nvar __metadata;\r\nvar __awaiter;\r\nvar __generator;\r\nvar __exportStar;\r\nvar __values;\r\nvar __read;\r\nvar __spread;\r\nvar __spreadArrays;\r\nvar __spreadArray;\r\nvar __await;\r\nvar __asyncGenerator;\r\nvar __asyncDelegator;\r\nvar __asyncValues;\r\nvar __makeTemplateObject;\r\nvar __importStar;\r\nvar __importDefault;\r\nvar __classPrivateFieldGet;\r\nvar __classPrivateFieldSet;\r\nvar __createBinding;\r\n(function (factory) {\r\n var root = typeof global === \"object\" ? global : typeof self === \"object\" ? self : typeof this === \"object\" ? this : {};\r\n if (typeof define === \"function\" && define.amd) {\r\n define(\"tslib\", [\"exports\"], function (exports) { factory(createExporter(root, createExporter(exports))); });\r\n }\r\n else if (typeof module === \"object\" && typeof module.exports === \"object\") {\r\n factory(createExporter(root, createExporter(module.exports)));\r\n }\r\n else {\r\n factory(createExporter(root));\r\n }\r\n function createExporter(exports, previous) {\r\n if (exports !== root) {\r\n if (typeof Object.create === \"function\") {\r\n Object.defineProperty(exports, \"__esModule\", { value: true });\r\n }\r\n else {\r\n exports.__esModule = true;\r\n }\r\n }\r\n return function (id, v) { return exports[id] = previous ? previous(id, v) : v; };\r\n }\r\n})\r\n(function (exporter) {\r\n var extendStatics = Object.setPrototypeOf ||\r\n ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||\r\n function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };\r\n\r\n __extends = function (d, b) {\r\n if (typeof b !== \"function\" && b !== null)\r\n throw new TypeError(\"Class extends value \" + String(b) + \" is not a constructor or null\");\r\n extendStatics(d, b);\r\n function __() { this.constructor = d; }\r\n d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());\r\n };\r\n\r\n __assign = Object.assign || function (t) {\r\n for (var s, i = 1, n = arguments.length; i < n; i++) {\r\n s = arguments[i];\r\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];\r\n }\r\n return t;\r\n };\r\n\r\n __rest = function (s, e) {\r\n var t = {};\r\n for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)\r\n t[p] = s[p];\r\n if (s != null && typeof Object.getOwnPropertySymbols === \"function\")\r\n for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {\r\n if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))\r\n t[p[i]] = s[p[i]];\r\n }\r\n return t;\r\n };\r\n\r\n __decorate = function (decorators, target, key, desc) {\r\n var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;\r\n if (typeof Reflect === \"object\" && typeof Reflect.decorate === \"function\") r = Reflect.decorate(decorators, target, key, desc);\r\n else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;\r\n return c > 3 && r && Object.defineProperty(target, key, r), r;\r\n };\r\n\r\n __param = function (paramIndex, decorator) {\r\n return function (target, key) { decorator(target, key, paramIndex); }\r\n };\r\n\r\n __metadata = function (metadataKey, metadataValue) {\r\n if (typeof Reflect === \"object\" && typeof Reflect.metadata === \"function\") return Reflect.metadata(metadataKey, metadataValue);\r\n };\r\n\r\n __awaiter = function (thisArg, _arguments, P, generator) {\r\n function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }\r\n return new (P || (P = Promise))(function (resolve, reject) {\r\n function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }\r\n function rejected(value) { try { step(generator[\"throw\"](value)); } catch (e) { reject(e); } }\r\n function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }\r\n step((generator = generator.apply(thisArg, _arguments || [])).next());\r\n });\r\n };\r\n\r\n __generator = function (thisArg, body) {\r\n var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;\r\n return g = { next: verb(0), \"throw\": verb(1), \"return\": verb(2) }, typeof Symbol === \"function\" && (g[Symbol.iterator] = function() { return this; }), g;\r\n function verb(n) { return function (v) { return step([n, v]); }; }\r\n function step(op) {\r\n if (f) throw new TypeError(\"Generator is already executing.\");\r\n while (_) try {\r\n if (f = 1, y && (t = op[0] & 2 ? y[\"return\"] : op[0] ? y[\"throw\"] || ((t = y[\"return\"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;\r\n if (y = 0, t) op = [op[0] & 2, t.value];\r\n switch (op[0]) {\r\n case 0: case 1: t = op; break;\r\n case 4: _.label++; return { value: op[1], done: false };\r\n case 5: _.label++; y = op[1]; op = [0]; continue;\r\n case 7: op = _.ops.pop(); _.trys.pop(); continue;\r\n default:\r\n if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }\r\n if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }\r\n if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }\r\n if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }\r\n if (t[2]) _.ops.pop();\r\n _.trys.pop(); continue;\r\n }\r\n op = body.call(thisArg, _);\r\n } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }\r\n if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };\r\n }\r\n };\r\n\r\n __exportStar = function(m, o) {\r\n for (var p in m) if (p !== \"default\" && !Object.prototype.hasOwnProperty.call(o, p)) __createBinding(o, m, p);\r\n };\r\n\r\n __createBinding = Object.create ? (function(o, m, k, k2) {\r\n if (k2 === undefined) k2 = k;\r\n Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });\r\n }) : (function(o, m, k, k2) {\r\n if (k2 === undefined) k2 = k;\r\n o[k2] = m[k];\r\n });\r\n\r\n __values = function (o) {\r\n var s = typeof Symbol === \"function\" && Symbol.iterator, m = s && o[s], i = 0;\r\n if (m) return m.call(o);\r\n if (o && typeof o.length === \"number\") return {\r\n next: function () {\r\n if (o && i >= o.length) o = void 0;\r\n return { value: o && o[i++], done: !o };\r\n }\r\n };\r\n throw new TypeError(s ? \"Object is not iterable.\" : \"Symbol.iterator is not defined.\");\r\n };\r\n\r\n __read = function (o, n) {\r\n var m = typeof Symbol === \"function\" && o[Symbol.iterator];\r\n if (!m) return o;\r\n var i = m.call(o), r, ar = [], e;\r\n try {\r\n while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);\r\n }\r\n catch (error) { e = { error: error }; }\r\n finally {\r\n try {\r\n if (r && !r.done && (m = i[\"return\"])) m.call(i);\r\n }\r\n finally { if (e) throw e.error; }\r\n }\r\n return ar;\r\n };\r\n\r\n /** @deprecated */\r\n __spread = function () {\r\n for (var ar = [], i = 0; i < arguments.length; i++)\r\n ar = ar.concat(__read(arguments[i]));\r\n return ar;\r\n };\r\n\r\n /** @deprecated */\r\n __spreadArrays = function () {\r\n for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;\r\n for (var r = Array(s), k = 0, i = 0; i < il; i++)\r\n for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)\r\n r[k] = a[j];\r\n return r;\r\n };\r\n\r\n __spreadArray = function (to, from, pack) {\r\n if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {\r\n if (ar || !(i in from)) {\r\n if (!ar) ar = Array.prototype.slice.call(from, 0, i);\r\n ar[i] = from[i];\r\n }\r\n }\r\n return to.concat(ar || Array.prototype.slice.call(from));\r\n };\r\n\r\n __await = function (v) {\r\n return this instanceof __await ? (this.v = v, this) : new __await(v);\r\n };\r\n\r\n __asyncGenerator = function (thisArg, _arguments, generator) {\r\n if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n var g = generator.apply(thisArg, _arguments || []), i, q = [];\r\n return i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i;\r\n function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }\r\n function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }\r\n function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }\r\n function fulfill(value) { resume(\"next\", value); }\r\n function reject(value) { resume(\"throw\", value); }\r\n function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }\r\n };\r\n\r\n __asyncDelegator = function (o) {\r\n var i, p;\r\n return i = {}, verb(\"next\"), verb(\"throw\", function (e) { throw e; }), verb(\"return\"), i[Symbol.iterator] = function () { return this; }, i;\r\n function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: n === \"return\" } : f ? f(v) : v; } : f; }\r\n };\r\n\r\n __asyncValues = function (o) {\r\n if (!Symbol.asyncIterator) throw new TypeError(\"Symbol.asyncIterator is not defined.\");\r\n var m = o[Symbol.asyncIterator], i;\r\n return m ? m.call(o) : (o = typeof __values === \"function\" ? __values(o) : o[Symbol.iterator](), i = {}, verb(\"next\"), verb(\"throw\"), verb(\"return\"), i[Symbol.asyncIterator] = function () { return this; }, i);\r\n function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }\r\n function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }\r\n };\r\n\r\n __makeTemplateObject = function (cooked, raw) {\r\n if (Object.defineProperty) { Object.defineProperty(cooked, \"raw\", { value: raw }); } else { cooked.raw = raw; }\r\n return cooked;\r\n };\r\n\r\n var __setModuleDefault = Object.create ? (function(o, v) {\r\n Object.defineProperty(o, \"default\", { enumerable: true, value: v });\r\n }) : function(o, v) {\r\n o[\"default\"] = v;\r\n };\r\n\r\n __importStar = function (mod) {\r\n if (mod && mod.__esModule) return mod;\r\n var result = {};\r\n if (mod != null) for (var k in mod) if (k !== \"default\" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);\r\n __setModuleDefault(result, mod);\r\n return result;\r\n };\r\n\r\n __importDefault = function (mod) {\r\n return (mod && mod.__esModule) ? mod : { \"default\": mod };\r\n };\r\n\r\n __classPrivateFieldGet = function (receiver, state, kind, f) {\r\n if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a getter\");\r\n if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot read private member from an object whose class did not declare it\");\r\n return kind === \"m\" ? f : kind === \"a\" ? f.call(receiver) : f ? f.value : state.get(receiver);\r\n };\r\n\r\n __classPrivateFieldSet = function (receiver, state, value, kind, f) {\r\n if (kind === \"m\") throw new TypeError(\"Private method is not writable\");\r\n if (kind === \"a\" && !f) throw new TypeError(\"Private accessor was defined without a setter\");\r\n if (typeof state === \"function\" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError(\"Cannot write private member to an object whose class did not declare it\");\r\n return (kind === \"a\" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;\r\n };\r\n\r\n exporter(\"__extends\", __extends);\r\n exporter(\"__assign\", __assign);\r\n exporter(\"__rest\", __rest);\r\n exporter(\"__decorate\", __decorate);\r\n exporter(\"__param\", __param);\r\n exporter(\"__metadata\", __metadata);\r\n exporter(\"__awaiter\", __awaiter);\r\n exporter(\"__generator\", __generator);\r\n exporter(\"__exportStar\", __exportStar);\r\n exporter(\"__createBinding\", __createBinding);\r\n exporter(\"__values\", __values);\r\n exporter(\"__read\", __read);\r\n exporter(\"__spread\", __spread);\r\n exporter(\"__spreadArrays\", __spreadArrays);\r\n exporter(\"__spreadArray\", __spreadArray);\r\n exporter(\"__await\", __await);\r\n exporter(\"__asyncGenerator\", __asyncGenerator);\r\n exporter(\"__asyncDelegator\", __asyncDelegator);\r\n exporter(\"__asyncValues\", __asyncValues);\r\n exporter(\"__makeTemplateObject\", __makeTemplateObject);\r\n exporter(\"__importStar\", __importStar);\r\n exporter(\"__importDefault\", __importDefault);\r\n exporter(\"__classPrivateFieldGet\", __classPrivateFieldGet);\r\n exporter(\"__classPrivateFieldSet\", __classPrivateFieldSet);\r\n});\r\n", "/*!\n * clipboard.js v2.0.11\n * https://clipboardjs.com/\n *\n * Licensed MIT \u00A9 Zeno Rocha\n */\n(function webpackUniversalModuleDefinition(root, factory) {\n\tif(typeof exports === 'object' && typeof module === 'object')\n\t\tmodule.exports = factory();\n\telse if(typeof define === 'function' && define.amd)\n\t\tdefine([], factory);\n\telse if(typeof exports === 'object')\n\t\texports[\"ClipboardJS\"] = factory();\n\telse\n\t\troot[\"ClipboardJS\"] = factory();\n})(this, function() {\nreturn /******/ (function() { // webpackBootstrap\n/******/ \tvar __webpack_modules__ = ({\n\n/***/ 686:\n/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {\n\n\"use strict\";\n\n// EXPORTS\n__webpack_require__.d(__webpack_exports__, {\n \"default\": function() { return /* binding */ clipboard; }\n});\n\n// EXTERNAL MODULE: ./node_modules/tiny-emitter/index.js\nvar tiny_emitter = __webpack_require__(279);\nvar tiny_emitter_default = /*#__PURE__*/__webpack_require__.n(tiny_emitter);\n// EXTERNAL MODULE: ./node_modules/good-listener/src/listen.js\nvar listen = __webpack_require__(370);\nvar listen_default = /*#__PURE__*/__webpack_require__.n(listen);\n// EXTERNAL MODULE: ./node_modules/select/src/select.js\nvar src_select = __webpack_require__(817);\nvar select_default = /*#__PURE__*/__webpack_require__.n(src_select);\n;// CONCATENATED MODULE: ./src/common/command.js\n/**\n * Executes a given operation type.\n * @param {String} type\n * @return {Boolean}\n */\nfunction command(type) {\n try {\n return document.execCommand(type);\n } catch (err) {\n return false;\n }\n}\n;// CONCATENATED MODULE: ./src/actions/cut.js\n\n\n/**\n * Cut action wrapper.\n * @param {String|HTMLElement} target\n * @return {String}\n */\n\nvar ClipboardActionCut = function ClipboardActionCut(target) {\n var selectedText = select_default()(target);\n command('cut');\n return selectedText;\n};\n\n/* harmony default export */ var actions_cut = (ClipboardActionCut);\n;// CONCATENATED MODULE: ./src/common/create-fake-element.js\n/**\n * Creates a fake textarea element with a value.\n * @param {String} value\n * @return {HTMLElement}\n */\nfunction createFakeElement(value) {\n var isRTL = document.documentElement.getAttribute('dir') === 'rtl';\n var fakeElement = document.createElement('textarea'); // Prevent zooming on iOS\n\n fakeElement.style.fontSize = '12pt'; // Reset box model\n\n fakeElement.style.border = '0';\n fakeElement.style.padding = '0';\n fakeElement.style.margin = '0'; // Move element out of screen horizontally\n\n fakeElement.style.position = 'absolute';\n fakeElement.style[isRTL ? 'right' : 'left'] = '-9999px'; // Move element to the same position vertically\n\n var yPosition = window.pageYOffset || document.documentElement.scrollTop;\n fakeElement.style.top = \"\".concat(yPosition, \"px\");\n fakeElement.setAttribute('readonly', '');\n fakeElement.value = value;\n return fakeElement;\n}\n;// CONCATENATED MODULE: ./src/actions/copy.js\n\n\n\n/**\n * Create fake copy action wrapper using a fake element.\n * @param {String} target\n * @param {Object} options\n * @return {String}\n */\n\nvar fakeCopyAction = function fakeCopyAction(value, options) {\n var fakeElement = createFakeElement(value);\n options.container.appendChild(fakeElement);\n var selectedText = select_default()(fakeElement);\n command('copy');\n fakeElement.remove();\n return selectedText;\n};\n/**\n * Copy action wrapper.\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @return {String}\n */\n\n\nvar ClipboardActionCopy = function ClipboardActionCopy(target) {\n var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n container: document.body\n };\n var selectedText = '';\n\n if (typeof target === 'string') {\n selectedText = fakeCopyAction(target, options);\n } else if (target instanceof HTMLInputElement && !['text', 'search', 'url', 'tel', 'password'].includes(target === null || target === void 0 ? void 0 : target.type)) {\n // If input type doesn't support `setSelectionRange`. Simulate it. https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setSelectionRange\n selectedText = fakeCopyAction(target.value, options);\n } else {\n selectedText = select_default()(target);\n command('copy');\n }\n\n return selectedText;\n};\n\n/* harmony default export */ var actions_copy = (ClipboardActionCopy);\n;// CONCATENATED MODULE: ./src/actions/default.js\nfunction _typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return _typeof(obj); }\n\n\n\n/**\n * Inner function which performs selection from either `text` or `target`\n * properties and then executes copy or cut operations.\n * @param {Object} options\n */\n\nvar ClipboardActionDefault = function ClipboardActionDefault() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n // Defines base properties passed from constructor.\n var _options$action = options.action,\n action = _options$action === void 0 ? 'copy' : _options$action,\n container = options.container,\n target = options.target,\n text = options.text; // Sets the `action` to be performed which can be either 'copy' or 'cut'.\n\n if (action !== 'copy' && action !== 'cut') {\n throw new Error('Invalid \"action\" value, use either \"copy\" or \"cut\"');\n } // Sets the `target` property using an element that will be have its content copied.\n\n\n if (target !== undefined) {\n if (target && _typeof(target) === 'object' && target.nodeType === 1) {\n if (action === 'copy' && target.hasAttribute('disabled')) {\n throw new Error('Invalid \"target\" attribute. Please use \"readonly\" instead of \"disabled\" attribute');\n }\n\n if (action === 'cut' && (target.hasAttribute('readonly') || target.hasAttribute('disabled'))) {\n throw new Error('Invalid \"target\" attribute. You can\\'t cut text from elements with \"readonly\" or \"disabled\" attributes');\n }\n } else {\n throw new Error('Invalid \"target\" value, use a valid Element');\n }\n } // Define selection strategy based on `text` property.\n\n\n if (text) {\n return actions_copy(text, {\n container: container\n });\n } // Defines which selection strategy based on `target` property.\n\n\n if (target) {\n return action === 'cut' ? actions_cut(target) : actions_copy(target, {\n container: container\n });\n }\n};\n\n/* harmony default export */ var actions_default = (ClipboardActionDefault);\n;// CONCATENATED MODULE: ./src/clipboard.js\nfunction clipboard_typeof(obj) { \"@babel/helpers - typeof\"; if (typeof Symbol === \"function\" && typeof Symbol.iterator === \"symbol\") { clipboard_typeof = function _typeof(obj) { return typeof obj; }; } else { clipboard_typeof = function _typeof(obj) { return obj && typeof Symbol === \"function\" && obj.constructor === Symbol && obj !== Symbol.prototype ? \"symbol\" : typeof obj; }; } return clipboard_typeof(obj); }\n\nfunction _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError(\"Cannot call a class as a function\"); } }\n\nfunction _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if (\"value\" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }\n\nfunction _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); return Constructor; }\n\nfunction _inherits(subClass, superClass) { if (typeof superClass !== \"function\" && superClass !== null) { throw new TypeError(\"Super expression must either be null or a function\"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); if (superClass) _setPrototypeOf(subClass, superClass); }\n\nfunction _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }\n\nfunction _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }\n\nfunction _possibleConstructorReturn(self, call) { if (call && (clipboard_typeof(call) === \"object\" || typeof call === \"function\")) { return call; } return _assertThisInitialized(self); }\n\nfunction _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError(\"this hasn't been initialised - super() hasn't been called\"); } return self; }\n\nfunction _isNativeReflectConstruct() { if (typeof Reflect === \"undefined\" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === \"function\") return true; try { Date.prototype.toString.call(Reflect.construct(Date, [], function () {})); return true; } catch (e) { return false; } }\n\nfunction _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }\n\n\n\n\n\n\n/**\n * Helper function to retrieve attribute value.\n * @param {String} suffix\n * @param {Element} element\n */\n\nfunction getAttributeValue(suffix, element) {\n var attribute = \"data-clipboard-\".concat(suffix);\n\n if (!element.hasAttribute(attribute)) {\n return;\n }\n\n return element.getAttribute(attribute);\n}\n/**\n * Base class which takes one or more elements, adds event listeners to them,\n * and instantiates a new `ClipboardAction` on each click.\n */\n\n\nvar Clipboard = /*#__PURE__*/function (_Emitter) {\n _inherits(Clipboard, _Emitter);\n\n var _super = _createSuper(Clipboard);\n\n /**\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n * @param {Object} options\n */\n function Clipboard(trigger, options) {\n var _this;\n\n _classCallCheck(this, Clipboard);\n\n _this = _super.call(this);\n\n _this.resolveOptions(options);\n\n _this.listenClick(trigger);\n\n return _this;\n }\n /**\n * Defines if attributes would be resolved using internal setter functions\n * or custom functions that were passed in the constructor.\n * @param {Object} options\n */\n\n\n _createClass(Clipboard, [{\n key: \"resolveOptions\",\n value: function resolveOptions() {\n var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};\n this.action = typeof options.action === 'function' ? options.action : this.defaultAction;\n this.target = typeof options.target === 'function' ? options.target : this.defaultTarget;\n this.text = typeof options.text === 'function' ? options.text : this.defaultText;\n this.container = clipboard_typeof(options.container) === 'object' ? options.container : document.body;\n }\n /**\n * Adds a click event listener to the passed trigger.\n * @param {String|HTMLElement|HTMLCollection|NodeList} trigger\n */\n\n }, {\n key: \"listenClick\",\n value: function listenClick(trigger) {\n var _this2 = this;\n\n this.listener = listen_default()(trigger, 'click', function (e) {\n return _this2.onClick(e);\n });\n }\n /**\n * Defines a new `ClipboardAction` on each click event.\n * @param {Event} e\n */\n\n }, {\n key: \"onClick\",\n value: function onClick(e) {\n var trigger = e.delegateTarget || e.currentTarget;\n var action = this.action(trigger) || 'copy';\n var text = actions_default({\n action: action,\n container: this.container,\n target: this.target(trigger),\n text: this.text(trigger)\n }); // Fires an event based on the copy operation result.\n\n this.emit(text ? 'success' : 'error', {\n action: action,\n text: text,\n trigger: trigger,\n clearSelection: function clearSelection() {\n if (trigger) {\n trigger.focus();\n }\n\n window.getSelection().removeAllRanges();\n }\n });\n }\n /**\n * Default `action` lookup function.\n * @param {Element} trigger\n */\n\n }, {\n key: \"defaultAction\",\n value: function defaultAction(trigger) {\n return getAttributeValue('action', trigger);\n }\n /**\n * Default `target` lookup function.\n * @param {Element} trigger\n */\n\n }, {\n key: \"defaultTarget\",\n value: function defaultTarget(trigger) {\n var selector = getAttributeValue('target', trigger);\n\n if (selector) {\n return document.querySelector(selector);\n }\n }\n /**\n * Allow fire programmatically a copy action\n * @param {String|HTMLElement} target\n * @param {Object} options\n * @returns Text copied.\n */\n\n }, {\n key: \"defaultText\",\n\n /**\n * Default `text` lookup function.\n * @param {Element} trigger\n */\n value: function defaultText(trigger) {\n return getAttributeValue('text', trigger);\n }\n /**\n * Destroy lifecycle.\n */\n\n }, {\n key: \"destroy\",\n value: function destroy() {\n this.listener.destroy();\n }\n }], [{\n key: \"copy\",\n value: function copy(target) {\n var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {\n container: document.body\n };\n return actions_copy(target, options);\n }\n /**\n * Allow fire programmatically a cut action\n * @param {String|HTMLElement} target\n * @returns Text cutted.\n */\n\n }, {\n key: \"cut\",\n value: function cut(target) {\n return actions_cut(target);\n }\n /**\n * Returns the support of the given action, or all actions if no action is\n * given.\n * @param {String} [action]\n */\n\n }, {\n key: \"isSupported\",\n value: function isSupported() {\n var action = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : ['copy', 'cut'];\n var actions = typeof action === 'string' ? [action] : action;\n var support = !!document.queryCommandSupported;\n actions.forEach(function (action) {\n support = support && !!document.queryCommandSupported(action);\n });\n return support;\n }\n }]);\n\n return Clipboard;\n}((tiny_emitter_default()));\n\n/* harmony default export */ var clipboard = (Clipboard);\n\n/***/ }),\n\n/***/ 828:\n/***/ (function(module) {\n\nvar DOCUMENT_NODE_TYPE = 9;\n\n/**\n * A polyfill for Element.matches()\n */\nif (typeof Element !== 'undefined' && !Element.prototype.matches) {\n var proto = Element.prototype;\n\n proto.matches = proto.matchesSelector ||\n proto.mozMatchesSelector ||\n proto.msMatchesSelector ||\n proto.oMatchesSelector ||\n proto.webkitMatchesSelector;\n}\n\n/**\n * Finds the closest parent that matches a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @return {Function}\n */\nfunction closest (element, selector) {\n while (element && element.nodeType !== DOCUMENT_NODE_TYPE) {\n if (typeof element.matches === 'function' &&\n element.matches(selector)) {\n return element;\n }\n element = element.parentNode;\n }\n}\n\nmodule.exports = closest;\n\n\n/***/ }),\n\n/***/ 438:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar closest = __webpack_require__(828);\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction _delegate(element, selector, type, callback, useCapture) {\n var listenerFn = listener.apply(this, arguments);\n\n element.addEventListener(type, listenerFn, useCapture);\n\n return {\n destroy: function() {\n element.removeEventListener(type, listenerFn, useCapture);\n }\n }\n}\n\n/**\n * Delegates event to a selector.\n *\n * @param {Element|String|Array} [elements]\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @param {Boolean} useCapture\n * @return {Object}\n */\nfunction delegate(elements, selector, type, callback, useCapture) {\n // Handle the regular Element usage\n if (typeof elements.addEventListener === 'function') {\n return _delegate.apply(null, arguments);\n }\n\n // Handle Element-less usage, it defaults to global delegation\n if (typeof type === 'function') {\n // Use `document` as the first parameter, then apply arguments\n // This is a short way to .unshift `arguments` without running into deoptimizations\n return _delegate.bind(null, document).apply(null, arguments);\n }\n\n // Handle Selector-based usage\n if (typeof elements === 'string') {\n elements = document.querySelectorAll(elements);\n }\n\n // Handle Array-like based usage\n return Array.prototype.map.call(elements, function (element) {\n return _delegate(element, selector, type, callback, useCapture);\n });\n}\n\n/**\n * Finds closest match and invokes callback.\n *\n * @param {Element} element\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Function}\n */\nfunction listener(element, selector, type, callback) {\n return function(e) {\n e.delegateTarget = closest(e.target, selector);\n\n if (e.delegateTarget) {\n callback.call(element, e);\n }\n }\n}\n\nmodule.exports = delegate;\n\n\n/***/ }),\n\n/***/ 879:\n/***/ (function(__unused_webpack_module, exports) {\n\n/**\n * Check if argument is a HTML element.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.node = function(value) {\n return value !== undefined\n && value instanceof HTMLElement\n && value.nodeType === 1;\n};\n\n/**\n * Check if argument is a list of HTML elements.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.nodeList = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return value !== undefined\n && (type === '[object NodeList]' || type === '[object HTMLCollection]')\n && ('length' in value)\n && (value.length === 0 || exports.node(value[0]));\n};\n\n/**\n * Check if argument is a string.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.string = function(value) {\n return typeof value === 'string'\n || value instanceof String;\n};\n\n/**\n * Check if argument is a function.\n *\n * @param {Object} value\n * @return {Boolean}\n */\nexports.fn = function(value) {\n var type = Object.prototype.toString.call(value);\n\n return type === '[object Function]';\n};\n\n\n/***/ }),\n\n/***/ 370:\n/***/ (function(module, __unused_webpack_exports, __webpack_require__) {\n\nvar is = __webpack_require__(879);\nvar delegate = __webpack_require__(438);\n\n/**\n * Validates all params and calls the right\n * listener function based on its target type.\n *\n * @param {String|HTMLElement|HTMLCollection|NodeList} target\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listen(target, type, callback) {\n if (!target && !type && !callback) {\n throw new Error('Missing required arguments');\n }\n\n if (!is.string(type)) {\n throw new TypeError('Second argument must be a String');\n }\n\n if (!is.fn(callback)) {\n throw new TypeError('Third argument must be a Function');\n }\n\n if (is.node(target)) {\n return listenNode(target, type, callback);\n }\n else if (is.nodeList(target)) {\n return listenNodeList(target, type, callback);\n }\n else if (is.string(target)) {\n return listenSelector(target, type, callback);\n }\n else {\n throw new TypeError('First argument must be a String, HTMLElement, HTMLCollection, or NodeList');\n }\n}\n\n/**\n * Adds an event listener to a HTML element\n * and returns a remove listener function.\n *\n * @param {HTMLElement} node\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNode(node, type, callback) {\n node.addEventListener(type, callback);\n\n return {\n destroy: function() {\n node.removeEventListener(type, callback);\n }\n }\n}\n\n/**\n * Add an event listener to a list of HTML elements\n * and returns a remove listener function.\n *\n * @param {NodeList|HTMLCollection} nodeList\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenNodeList(nodeList, type, callback) {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.addEventListener(type, callback);\n });\n\n return {\n destroy: function() {\n Array.prototype.forEach.call(nodeList, function(node) {\n node.removeEventListener(type, callback);\n });\n }\n }\n}\n\n/**\n * Add an event listener to a selector\n * and returns a remove listener function.\n *\n * @param {String} selector\n * @param {String} type\n * @param {Function} callback\n * @return {Object}\n */\nfunction listenSelector(selector, type, callback) {\n return delegate(document.body, selector, type, callback);\n}\n\nmodule.exports = listen;\n\n\n/***/ }),\n\n/***/ 817:\n/***/ (function(module) {\n\nfunction select(element) {\n var selectedText;\n\n if (element.nodeName === 'SELECT') {\n element.focus();\n\n selectedText = element.value;\n }\n else if (element.nodeName === 'INPUT' || element.nodeName === 'TEXTAREA') {\n var isReadOnly = element.hasAttribute('readonly');\n\n if (!isReadOnly) {\n element.setAttribute('readonly', '');\n }\n\n element.select();\n element.setSelectionRange(0, element.value.length);\n\n if (!isReadOnly) {\n element.removeAttribute('readonly');\n }\n\n selectedText = element.value;\n }\n else {\n if (element.hasAttribute('contenteditable')) {\n element.focus();\n }\n\n var selection = window.getSelection();\n var range = document.createRange();\n\n range.selectNodeContents(element);\n selection.removeAllRanges();\n selection.addRange(range);\n\n selectedText = selection.toString();\n }\n\n return selectedText;\n}\n\nmodule.exports = select;\n\n\n/***/ }),\n\n/***/ 279:\n/***/ (function(module) {\n\nfunction E () {\n // Keep this empty so it's easier to inherit from\n // (via https://github.com/lipsmack from https://github.com/scottcorgan/tiny-emitter/issues/3)\n}\n\nE.prototype = {\n on: function (name, callback, ctx) {\n var e = this.e || (this.e = {});\n\n (e[name] || (e[name] = [])).push({\n fn: callback,\n ctx: ctx\n });\n\n return this;\n },\n\n once: function (name, callback, ctx) {\n var self = this;\n function listener () {\n self.off(name, listener);\n callback.apply(ctx, arguments);\n };\n\n listener._ = callback\n return this.on(name, listener, ctx);\n },\n\n emit: function (name) {\n var data = [].slice.call(arguments, 1);\n var evtArr = ((this.e || (this.e = {}))[name] || []).slice();\n var i = 0;\n var len = evtArr.length;\n\n for (i; i < len; i++) {\n evtArr[i].fn.apply(evtArr[i].ctx, data);\n }\n\n return this;\n },\n\n off: function (name, callback) {\n var e = this.e || (this.e = {});\n var evts = e[name];\n var liveEvents = [];\n\n if (evts && callback) {\n for (var i = 0, len = evts.length; i < len; i++) {\n if (evts[i].fn !== callback && evts[i].fn._ !== callback)\n liveEvents.push(evts[i]);\n }\n }\n\n // Remove event from queue to prevent memory leak\n // Suggested by https://github.com/lazd\n // Ref: https://github.com/scottcorgan/tiny-emitter/commit/c6ebfaa9bc973b33d110a84a307742b7cf94c953#commitcomment-5024910\n\n (liveEvents.length)\n ? e[name] = liveEvents\n : delete e[name];\n\n return this;\n }\n};\n\nmodule.exports = E;\nmodule.exports.TinyEmitter = E;\n\n\n/***/ })\n\n/******/ \t});\n/************************************************************************/\n/******/ \t// The module cache\n/******/ \tvar __webpack_module_cache__ = {};\n/******/ \t\n/******/ \t// The require function\n/******/ \tfunction __webpack_require__(moduleId) {\n/******/ \t\t// Check if module is in cache\n/******/ \t\tif(__webpack_module_cache__[moduleId]) {\n/******/ \t\t\treturn __webpack_module_cache__[moduleId].exports;\n/******/ \t\t}\n/******/ \t\t// Create a new module (and put it into the cache)\n/******/ \t\tvar module = __webpack_module_cache__[moduleId] = {\n/******/ \t\t\t// no module.id needed\n/******/ \t\t\t// no module.loaded needed\n/******/ \t\t\texports: {}\n/******/ \t\t};\n/******/ \t\n/******/ \t\t// Execute the module function\n/******/ \t\t__webpack_modules__[moduleId](module, module.exports, __webpack_require__);\n/******/ \t\n/******/ \t\t// Return the exports of the module\n/******/ \t\treturn module.exports;\n/******/ \t}\n/******/ \t\n/************************************************************************/\n/******/ \t/* webpack/runtime/compat get default export */\n/******/ \t!function() {\n/******/ \t\t// getDefaultExport function for compatibility with non-harmony modules\n/******/ \t\t__webpack_require__.n = function(module) {\n/******/ \t\t\tvar getter = module && module.__esModule ?\n/******/ \t\t\t\tfunction() { return module['default']; } :\n/******/ \t\t\t\tfunction() { return module; };\n/******/ \t\t\t__webpack_require__.d(getter, { a: getter });\n/******/ \t\t\treturn getter;\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/define property getters */\n/******/ \t!function() {\n/******/ \t\t// define getter functions for harmony exports\n/******/ \t\t__webpack_require__.d = function(exports, definition) {\n/******/ \t\t\tfor(var key in definition) {\n/******/ \t\t\t\tif(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n/******/ \t\t\t\t\tObject.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n/******/ \t\t\t\t}\n/******/ \t\t\t}\n/******/ \t\t};\n/******/ \t}();\n/******/ \t\n/******/ \t/* webpack/runtime/hasOwnProperty shorthand */\n/******/ \t!function() {\n/******/ \t\t__webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); }\n/******/ \t}();\n/******/ \t\n/************************************************************************/\n/******/ \t// module exports must be returned from runtime so entry inlining is disabled\n/******/ \t// startup\n/******/ \t// Load entry module and return exports\n/******/ \treturn __webpack_require__(686);\n/******/ })()\n.default;\n});", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n var str = '' + string;\n var match = matchHtmlRegExp.exec(str);\n\n if (!match) {\n return str;\n }\n\n var escape;\n var html = '';\n var index = 0;\n var lastIndex = 0;\n\n for (index = match.index; index < str.length; index++) {\n switch (str.charCodeAt(index)) {\n case 34: // \"\n escape = '"';\n break;\n case 38: // &\n escape = '&';\n break;\n case 39: // '\n escape = ''';\n break;\n case 60: // <\n escape = '<';\n break;\n case 62: // >\n escape = '>';\n break;\n default:\n continue;\n }\n\n if (lastIndex !== index) {\n html += str.substring(lastIndex, index);\n }\n\n lastIndex = index + 1;\n html += escape;\n }\n\n return lastIndex !== index\n ? html + str.substring(lastIndex, index)\n : html;\n}\n", "Array.prototype.flat||Object.defineProperty(Array.prototype,\"flat\",{configurable:!0,value:function r(){var t=isNaN(arguments[0])?1:Number(arguments[0]);return t?Array.prototype.reduce.call(this,function(a,e){return Array.isArray(e)?a.push.apply(a,r.call(e,t-1)):a.push(e),a},[]):Array.prototype.slice.call(this)},writable:!0}),Array.prototype.flatMap||Object.defineProperty(Array.prototype,\"flatMap\",{configurable:!0,value:function(r){return Array.prototype.map.apply(this,arguments).flat()},writable:!0})\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport \"array-flat-polyfill\"\nimport \"focus-visible\"\nimport \"unfetch/polyfill\"\nimport \"url-polyfill\"\n\nimport {\n EMPTY,\n NEVER,\n Subject,\n defer,\n delay,\n filter,\n map,\n merge,\n mergeWith,\n shareReplay,\n switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"./_\"\nimport {\n at,\n getOptionalElement,\n requestJSON,\n setToggle,\n watchDocument,\n watchKeyboard,\n watchLocation,\n watchLocationTarget,\n watchMedia,\n watchPrint,\n watchViewport\n} from \"./browser\"\nimport {\n getComponentElement,\n getComponentElements,\n mountAnnounce,\n mountBackToTop,\n mountConsent,\n mountContent,\n mountDialog,\n mountHeader,\n mountHeaderTitle,\n mountPalette,\n mountSearch,\n mountSearchHiglight,\n mountSidebar,\n mountSource,\n mountTableOfContents,\n mountTabs,\n watchHeader,\n watchMain\n} from \"./components\"\nimport {\n SearchIndex,\n setupClipboardJS,\n setupInstantLoading,\n setupVersionSelector\n} from \"./integrations\"\nimport {\n patchIndeterminate,\n patchScrollfix,\n patchScrolllock\n} from \"./patches\"\nimport \"./polyfills\"\n\n/* ----------------------------------------------------------------------------\n * Application\n * ------------------------------------------------------------------------- */\n\n/* Yay, JavaScript is available */\ndocument.documentElement.classList.remove(\"no-js\")\ndocument.documentElement.classList.add(\"js\")\n\n/* Set up navigation observables and subjects */\nconst document$ = watchDocument()\nconst location$ = watchLocation()\nconst target$ = watchLocationTarget()\nconst keyboard$ = watchKeyboard()\n\n/* Set up media observables */\nconst viewport$ = watchViewport()\nconst tablet$ = watchMedia(\"(min-width: 960px)\")\nconst screen$ = watchMedia(\"(min-width: 1220px)\")\nconst print$ = watchPrint()\n\n/* Retrieve search index, if search is enabled */\nconst config = configuration()\nconst index$ = document.forms.namedItem(\"search\")\n ? __search?.index || requestJSON(\n new URL(\"search/search_index.json\", config.base)\n )\n : NEVER\n\n/* Set up Clipboard.js integration */\nconst alert$ = new Subject()\nsetupClipboardJS({ alert$ })\n\n/* Set up instant loading, if enabled */\nif (feature(\"navigation.instant\"))\n setupInstantLoading({ document$, location$, viewport$ })\n\n/* Set up version selector */\nif (config.version?.provider === \"mike\")\n setupVersionSelector({ document$ })\n\n/* Always close drawer and search on navigation */\nmerge(location$, target$)\n .pipe(\n delay(125)\n )\n .subscribe(() => {\n setToggle(\"drawer\", false)\n setToggle(\"search\", false)\n })\n\n/* Set up global keyboard handlers */\nkeyboard$\n .pipe(\n filter(({ mode }) => mode === \"global\")\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Go to previous page */\n case \"p\":\n case \",\":\n const prev = getOptionalElement(\"[href][rel=prev]\")\n if (typeof prev !== \"undefined\")\n prev.click()\n break\n\n /* Go to next page */\n case \"n\":\n case \".\":\n const next = getOptionalElement(\"[href][rel=next]\")\n if (typeof next !== \"undefined\")\n next.click()\n break\n }\n })\n\n/* Set up patches */\npatchIndeterminate({ document$, tablet$ })\npatchScrollfix({ document$ })\npatchScrolllock({ viewport$, tablet$ })\n\n/* Set up header and main area observable */\nconst header$ = watchHeader(getComponentElement(\"header\"), { viewport$ })\nconst main$ = document$\n .pipe(\n map(() => getComponentElement(\"main\")),\n switchMap(el => watchMain(el, { viewport$, header$ })),\n shareReplay(1)\n )\n\n/* Set up control component observables */\nconst control$ = merge(\n\n /* Consent */\n ...getComponentElements(\"consent\")\n .map(el => mountConsent(el, { target$ })),\n\n /* Dialog */\n ...getComponentElements(\"dialog\")\n .map(el => mountDialog(el, { alert$ })),\n\n /* Header */\n ...getComponentElements(\"header\")\n .map(el => mountHeader(el, { viewport$, header$, main$ })),\n\n /* Color palette */\n ...getComponentElements(\"palette\")\n .map(el => mountPalette(el)),\n\n /* Search */\n ...getComponentElements(\"search\")\n .map(el => mountSearch(el, { index$, keyboard$ })),\n\n /* Repository information */\n ...getComponentElements(\"source\")\n .map(el => mountSource(el))\n)\n\n/* Set up content component observables */\nconst content$ = defer(() => merge(\n\n /* Announcement bar */\n ...getComponentElements(\"announce\")\n .map(el => mountAnnounce(el)),\n\n /* Content */\n ...getComponentElements(\"content\")\n .map(el => mountContent(el, { viewport$, target$, print$ })),\n\n /* Search highlighting */\n ...getComponentElements(\"content\")\n .map(el => feature(\"search.highlight\")\n ? mountSearchHiglight(el, { index$, location$ })\n : EMPTY\n ),\n\n /* Header title */\n ...getComponentElements(\"header-title\")\n .map(el => mountHeaderTitle(el, { viewport$, header$ })),\n\n /* Sidebar */\n ...getComponentElements(\"sidebar\")\n .map(el => el.getAttribute(\"data-md-type\") === \"navigation\"\n ? at(screen$, () => mountSidebar(el, { viewport$, header$, main$ }))\n : at(tablet$, () => mountSidebar(el, { viewport$, header$, main$ }))\n ),\n\n /* Navigation tabs */\n ...getComponentElements(\"tabs\")\n .map(el => mountTabs(el, { viewport$, header$ })),\n\n /* Table of contents */\n ...getComponentElements(\"toc\")\n .map(el => mountTableOfContents(el, { viewport$, header$, target$ })),\n\n /* Back-to-top button */\n ...getComponentElements(\"top\")\n .map(el => mountBackToTop(el, { viewport$, header$, main$, target$ }))\n))\n\n/* Set up component observables */\nconst component$ = document$\n .pipe(\n switchMap(() => content$),\n mergeWith(control$),\n shareReplay(1)\n )\n\n/* Subscribe to all components */\ncomponent$.subscribe()\n\n/* ----------------------------------------------------------------------------\n * Exports\n * ------------------------------------------------------------------------- */\n\nwindow.document$ = document$ /* Document observable */\nwindow.location$ = location$ /* Location subject */\nwindow.target$ = target$ /* Location target observable */\nwindow.keyboard$ = keyboard$ /* Keyboard observable */\nwindow.viewport$ = viewport$ /* Viewport observable */\nwindow.tablet$ = tablet$ /* Media tablet observable */\nwindow.screen$ = screen$ /* Media screen observable */\nwindow.print$ = print$ /* Media print observable */\nwindow.alert$ = alert$ /* Alert subject */\nwindow.component$ = component$ /* Component observable */\n", "self.fetch||(self.fetch=function(e,n){return n=n||{},new Promise(function(t,s){var r=new XMLHttpRequest,o=[],u=[],i={},a=function(){return{ok:2==(r.status/100|0),statusText:r.statusText,status:r.status,url:r.responseURL,text:function(){return Promise.resolve(r.responseText)},json:function(){return Promise.resolve(r.responseText).then(JSON.parse)},blob:function(){return Promise.resolve(new Blob([r.response]))},clone:a,headers:{keys:function(){return o},entries:function(){return u},get:function(e){return i[e.toLowerCase()]},has:function(e){return e.toLowerCase()in i}}}};for(var c in r.open(n.method||\"get\",e,!0),r.onload=function(){r.getAllResponseHeaders().replace(/^(.*?):[^\\S\\n]*([\\s\\S]*?)$/gm,function(e,n,t){o.push(n=n.toLowerCase()),u.push([n,t]),i[n]=i[n]?i[n]+\",\"+t:t}),t(a())},r.onerror=s,r.withCredentials=\"include\"==n.credentials,n.headers)r.setRequestHeader(c,n.headers[c]);r.send(n.body||null)})});\n", "import tslib from '../tslib.js';\r\nconst {\r\n __extends,\r\n __assign,\r\n __rest,\r\n __decorate,\r\n __param,\r\n __metadata,\r\n __awaiter,\r\n __generator,\r\n __exportStar,\r\n __createBinding,\r\n __values,\r\n __read,\r\n __spread,\r\n __spreadArrays,\r\n __spreadArray,\r\n __await,\r\n __asyncGenerator,\r\n __asyncDelegator,\r\n __asyncValues,\r\n __makeTemplateObject,\r\n __importStar,\r\n __importDefault,\r\n __classPrivateFieldGet,\r\n __classPrivateFieldSet,\r\n} = tslib;\r\nexport {\r\n __extends,\r\n __assign,\r\n __rest,\r\n __decorate,\r\n __param,\r\n __metadata,\r\n __awaiter,\r\n __generator,\r\n __exportStar,\r\n __createBinding,\r\n __values,\r\n __read,\r\n __spread,\r\n __spreadArrays,\r\n __spreadArray,\r\n __await,\r\n __asyncGenerator,\r\n __asyncDelegator,\r\n __asyncValues,\r\n __makeTemplateObject,\r\n __importStar,\r\n __importDefault,\r\n __classPrivateFieldGet,\r\n __classPrivateFieldSet,\r\n};\r\n", null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n ReplaySubject,\n Subject,\n fromEvent\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch document\n *\n * Documents are implemented as subjects, so all downstream observables are\n * automatically updated when a new document is emitted.\n *\n * @returns Document subject\n */\nexport function watchDocument(): Subject {\n const document$ = new ReplaySubject(1)\n fromEvent(document, \"DOMContentLoaded\", { once: true })\n .subscribe(() => document$.next(document))\n\n /* Return document */\n return document$\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve all elements matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getElements(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T][]\n\nexport function getElements(\n selector: string, node?: ParentNode\n): T[]\n\nexport function getElements(\n selector: string, node: ParentNode = document\n): T[] {\n return Array.from(node.querySelectorAll(selector))\n}\n\n/**\n * Retrieve an element matching a query selector or throw a reference error\n *\n * Note that this function assumes that the element is present. If unsure if an\n * element is existent, use the `getOptionalElement` function instead.\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getElement(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T]\n\nexport function getElement(\n selector: string, node?: ParentNode\n): T\n\nexport function getElement(\n selector: string, node: ParentNode = document\n): T {\n const el = getOptionalElement(selector, node)\n if (typeof el === \"undefined\")\n throw new ReferenceError(\n `Missing element: expected \"${selector}\" to be present`\n )\n\n /* Return element */\n return el\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Retrieve an optional element matching the query selector\n *\n * @template T - Element type\n *\n * @param selector - Query selector\n * @param node - Node of reference\n *\n * @returns Element or nothing\n */\nexport function getOptionalElement(\n selector: T, node?: ParentNode\n): HTMLElementTagNameMap[T] | undefined\n\nexport function getOptionalElement(\n selector: string, node?: ParentNode\n): T | undefined\n\nexport function getOptionalElement(\n selector: string, node: ParentNode = document\n): T | undefined {\n return node.querySelector(selector) || undefined\n}\n\n/**\n * Retrieve the currently active element\n *\n * @returns Element or nothing\n */\nexport function getActiveElement(): HTMLElement | undefined {\n return document.activeElement instanceof HTMLElement\n ? document.activeElement || undefined\n : undefined\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n debounceTime,\n distinctUntilChanged,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element focus\n *\n * Previously, this function used `focus` and `blur` events to determine whether\n * an element is focused, but this doesn't work if there are focusable elements\n * within the elements itself. A better solutions are `focusin` and `focusout`\n * events, which bubble up the tree and allow for more fine-grained control.\n *\n * `debounceTime` is necessary, because when a focus change happens inside an\n * element, the observable would first emit `false` and then `true` again.\n *\n * @param el - Element\n *\n * @returns Element focus observable\n */\nexport function watchElementFocus(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(document.body, \"focusin\"),\n fromEvent(document.body, \"focusout\")\n )\n .pipe(\n debounceTime(1),\n map(() => {\n const active = getActiveElement()\n return typeof active !== \"undefined\"\n ? el.contains(active)\n : false\n }),\n startWith(el === getActiveElement()),\n distinctUntilChanged()\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n animationFrameScheduler,\n auditTime,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementOffset {\n x: number /* Horizontal offset */\n y: number /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element offset\n *\n * @param el - Element\n *\n * @returns Element offset\n */\nexport function getElementOffset(\n el: HTMLElement\n): ElementOffset {\n return {\n x: el.offsetLeft,\n y: el.offsetTop\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element offset\n *\n * @param el - Element\n *\n * @returns Element offset observable\n */\nexport function watchElementOffset(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(window, \"load\"),\n fromEvent(window, \"resize\")\n )\n .pipe(\n auditTime(0, animationFrameScheduler),\n map(() => getElementOffset(el)),\n startWith(getElementOffset(el))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n animationFrameScheduler,\n auditTime,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\nimport { ElementOffset } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content offset (= scroll offset)\n *\n * @param el - Element\n *\n * @returns Element content offset\n */\nexport function getElementContentOffset(\n el: HTMLElement\n): ElementOffset {\n return {\n x: el.scrollLeft,\n y: el.scrollTop\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element content offset\n *\n * @param el - Element\n *\n * @returns Element content offset observable\n */\nexport function watchElementContentOffset(\n el: HTMLElement\n): Observable {\n return merge(\n fromEvent(el, \"scroll\"),\n fromEvent(window, \"resize\")\n )\n .pipe(\n auditTime(0, animationFrameScheduler),\n map(() => getElementContentOffset(el)),\n startWith(getElementContentOffset(el))\n )\n}\n", "/**\r\n * A collection of shims that provide minimal functionality of the ES6 collections.\r\n *\r\n * These implementations are not meant to be used outside of the ResizeObserver\r\n * modules as they cover only a limited range of use cases.\r\n */\r\n/* eslint-disable require-jsdoc, valid-jsdoc */\r\nvar MapShim = (function () {\r\n if (typeof Map !== 'undefined') {\r\n return Map;\r\n }\r\n /**\r\n * Returns index in provided array that matches the specified key.\r\n *\r\n * @param {Array} arr\r\n * @param {*} key\r\n * @returns {number}\r\n */\r\n function getIndex(arr, key) {\r\n var result = -1;\r\n arr.some(function (entry, index) {\r\n if (entry[0] === key) {\r\n result = index;\r\n return true;\r\n }\r\n return false;\r\n });\r\n return result;\r\n }\r\n return /** @class */ (function () {\r\n function class_1() {\r\n this.__entries__ = [];\r\n }\r\n Object.defineProperty(class_1.prototype, \"size\", {\r\n /**\r\n * @returns {boolean}\r\n */\r\n get: function () {\r\n return this.__entries__.length;\r\n },\r\n enumerable: true,\r\n configurable: true\r\n });\r\n /**\r\n * @param {*} key\r\n * @returns {*}\r\n */\r\n class_1.prototype.get = function (key) {\r\n var index = getIndex(this.__entries__, key);\r\n var entry = this.__entries__[index];\r\n return entry && entry[1];\r\n };\r\n /**\r\n * @param {*} key\r\n * @param {*} value\r\n * @returns {void}\r\n */\r\n class_1.prototype.set = function (key, value) {\r\n var index = getIndex(this.__entries__, key);\r\n if (~index) {\r\n this.__entries__[index][1] = value;\r\n }\r\n else {\r\n this.__entries__.push([key, value]);\r\n }\r\n };\r\n /**\r\n * @param {*} key\r\n * @returns {void}\r\n */\r\n class_1.prototype.delete = function (key) {\r\n var entries = this.__entries__;\r\n var index = getIndex(entries, key);\r\n if (~index) {\r\n entries.splice(index, 1);\r\n }\r\n };\r\n /**\r\n * @param {*} key\r\n * @returns {void}\r\n */\r\n class_1.prototype.has = function (key) {\r\n return !!~getIndex(this.__entries__, key);\r\n };\r\n /**\r\n * @returns {void}\r\n */\r\n class_1.prototype.clear = function () {\r\n this.__entries__.splice(0);\r\n };\r\n /**\r\n * @param {Function} callback\r\n * @param {*} [ctx=null]\r\n * @returns {void}\r\n */\r\n class_1.prototype.forEach = function (callback, ctx) {\r\n if (ctx === void 0) { ctx = null; }\r\n for (var _i = 0, _a = this.__entries__; _i < _a.length; _i++) {\r\n var entry = _a[_i];\r\n callback.call(ctx, entry[1], entry[0]);\r\n }\r\n };\r\n return class_1;\r\n }());\r\n})();\n\n/**\r\n * Detects whether window and document objects are available in current environment.\r\n */\r\nvar isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined' && window.document === document;\n\n// Returns global object of a current environment.\r\nvar global$1 = (function () {\r\n if (typeof global !== 'undefined' && global.Math === Math) {\r\n return global;\r\n }\r\n if (typeof self !== 'undefined' && self.Math === Math) {\r\n return self;\r\n }\r\n if (typeof window !== 'undefined' && window.Math === Math) {\r\n return window;\r\n }\r\n // eslint-disable-next-line no-new-func\r\n return Function('return this')();\r\n})();\n\n/**\r\n * A shim for the requestAnimationFrame which falls back to the setTimeout if\r\n * first one is not supported.\r\n *\r\n * @returns {number} Requests' identifier.\r\n */\r\nvar requestAnimationFrame$1 = (function () {\r\n if (typeof requestAnimationFrame === 'function') {\r\n // It's required to use a bounded function because IE sometimes throws\r\n // an \"Invalid calling object\" error if rAF is invoked without the global\r\n // object on the left hand side.\r\n return requestAnimationFrame.bind(global$1);\r\n }\r\n return function (callback) { return setTimeout(function () { return callback(Date.now()); }, 1000 / 60); };\r\n})();\n\n// Defines minimum timeout before adding a trailing call.\r\nvar trailingTimeout = 2;\r\n/**\r\n * Creates a wrapper function which ensures that provided callback will be\r\n * invoked only once during the specified delay period.\r\n *\r\n * @param {Function} callback - Function to be invoked after the delay period.\r\n * @param {number} delay - Delay after which to invoke callback.\r\n * @returns {Function}\r\n */\r\nfunction throttle (callback, delay) {\r\n var leadingCall = false, trailingCall = false, lastCallTime = 0;\r\n /**\r\n * Invokes the original callback function and schedules new invocation if\r\n * the \"proxy\" was called during current request.\r\n *\r\n * @returns {void}\r\n */\r\n function resolvePending() {\r\n if (leadingCall) {\r\n leadingCall = false;\r\n callback();\r\n }\r\n if (trailingCall) {\r\n proxy();\r\n }\r\n }\r\n /**\r\n * Callback invoked after the specified delay. It will further postpone\r\n * invocation of the original function delegating it to the\r\n * requestAnimationFrame.\r\n *\r\n * @returns {void}\r\n */\r\n function timeoutCallback() {\r\n requestAnimationFrame$1(resolvePending);\r\n }\r\n /**\r\n * Schedules invocation of the original function.\r\n *\r\n * @returns {void}\r\n */\r\n function proxy() {\r\n var timeStamp = Date.now();\r\n if (leadingCall) {\r\n // Reject immediately following calls.\r\n if (timeStamp - lastCallTime < trailingTimeout) {\r\n return;\r\n }\r\n // Schedule new call to be in invoked when the pending one is resolved.\r\n // This is important for \"transitions\" which never actually start\r\n // immediately so there is a chance that we might miss one if change\r\n // happens amids the pending invocation.\r\n trailingCall = true;\r\n }\r\n else {\r\n leadingCall = true;\r\n trailingCall = false;\r\n setTimeout(timeoutCallback, delay);\r\n }\r\n lastCallTime = timeStamp;\r\n }\r\n return proxy;\r\n}\n\n// Minimum delay before invoking the update of observers.\r\nvar REFRESH_DELAY = 20;\r\n// A list of substrings of CSS properties used to find transition events that\r\n// might affect dimensions of observed elements.\r\nvar transitionKeys = ['top', 'right', 'bottom', 'left', 'width', 'height', 'size', 'weight'];\r\n// Check if MutationObserver is available.\r\nvar mutationObserverSupported = typeof MutationObserver !== 'undefined';\r\n/**\r\n * Singleton controller class which handles updates of ResizeObserver instances.\r\n */\r\nvar ResizeObserverController = /** @class */ (function () {\r\n /**\r\n * Creates a new instance of ResizeObserverController.\r\n *\r\n * @private\r\n */\r\n function ResizeObserverController() {\r\n /**\r\n * Indicates whether DOM listeners have been added.\r\n *\r\n * @private {boolean}\r\n */\r\n this.connected_ = false;\r\n /**\r\n * Tells that controller has subscribed for Mutation Events.\r\n *\r\n * @private {boolean}\r\n */\r\n this.mutationEventsAdded_ = false;\r\n /**\r\n * Keeps reference to the instance of MutationObserver.\r\n *\r\n * @private {MutationObserver}\r\n */\r\n this.mutationsObserver_ = null;\r\n /**\r\n * A list of connected observers.\r\n *\r\n * @private {Array}\r\n */\r\n this.observers_ = [];\r\n this.onTransitionEnd_ = this.onTransitionEnd_.bind(this);\r\n this.refresh = throttle(this.refresh.bind(this), REFRESH_DELAY);\r\n }\r\n /**\r\n * Adds observer to observers list.\r\n *\r\n * @param {ResizeObserverSPI} observer - Observer to be added.\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.addObserver = function (observer) {\r\n if (!~this.observers_.indexOf(observer)) {\r\n this.observers_.push(observer);\r\n }\r\n // Add listeners if they haven't been added yet.\r\n if (!this.connected_) {\r\n this.connect_();\r\n }\r\n };\r\n /**\r\n * Removes observer from observers list.\r\n *\r\n * @param {ResizeObserverSPI} observer - Observer to be removed.\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.removeObserver = function (observer) {\r\n var observers = this.observers_;\r\n var index = observers.indexOf(observer);\r\n // Remove observer if it's present in registry.\r\n if (~index) {\r\n observers.splice(index, 1);\r\n }\r\n // Remove listeners if controller has no connected observers.\r\n if (!observers.length && this.connected_) {\r\n this.disconnect_();\r\n }\r\n };\r\n /**\r\n * Invokes the update of observers. It will continue running updates insofar\r\n * it detects changes.\r\n *\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.refresh = function () {\r\n var changesDetected = this.updateObservers_();\r\n // Continue running updates if changes have been detected as there might\r\n // be future ones caused by CSS transitions.\r\n if (changesDetected) {\r\n this.refresh();\r\n }\r\n };\r\n /**\r\n * Updates every observer from observers list and notifies them of queued\r\n * entries.\r\n *\r\n * @private\r\n * @returns {boolean} Returns \"true\" if any observer has detected changes in\r\n * dimensions of it's elements.\r\n */\r\n ResizeObserverController.prototype.updateObservers_ = function () {\r\n // Collect observers that have active observations.\r\n var activeObservers = this.observers_.filter(function (observer) {\r\n return observer.gatherActive(), observer.hasActive();\r\n });\r\n // Deliver notifications in a separate cycle in order to avoid any\r\n // collisions between observers, e.g. when multiple instances of\r\n // ResizeObserver are tracking the same element and the callback of one\r\n // of them changes content dimensions of the observed target. Sometimes\r\n // this may result in notifications being blocked for the rest of observers.\r\n activeObservers.forEach(function (observer) { return observer.broadcastActive(); });\r\n return activeObservers.length > 0;\r\n };\r\n /**\r\n * Initializes DOM listeners.\r\n *\r\n * @private\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.connect_ = function () {\r\n // Do nothing if running in a non-browser environment or if listeners\r\n // have been already added.\r\n if (!isBrowser || this.connected_) {\r\n return;\r\n }\r\n // Subscription to the \"Transitionend\" event is used as a workaround for\r\n // delayed transitions. This way it's possible to capture at least the\r\n // final state of an element.\r\n document.addEventListener('transitionend', this.onTransitionEnd_);\r\n window.addEventListener('resize', this.refresh);\r\n if (mutationObserverSupported) {\r\n this.mutationsObserver_ = new MutationObserver(this.refresh);\r\n this.mutationsObserver_.observe(document, {\r\n attributes: true,\r\n childList: true,\r\n characterData: true,\r\n subtree: true\r\n });\r\n }\r\n else {\r\n document.addEventListener('DOMSubtreeModified', this.refresh);\r\n this.mutationEventsAdded_ = true;\r\n }\r\n this.connected_ = true;\r\n };\r\n /**\r\n * Removes DOM listeners.\r\n *\r\n * @private\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.disconnect_ = function () {\r\n // Do nothing if running in a non-browser environment or if listeners\r\n // have been already removed.\r\n if (!isBrowser || !this.connected_) {\r\n return;\r\n }\r\n document.removeEventListener('transitionend', this.onTransitionEnd_);\r\n window.removeEventListener('resize', this.refresh);\r\n if (this.mutationsObserver_) {\r\n this.mutationsObserver_.disconnect();\r\n }\r\n if (this.mutationEventsAdded_) {\r\n document.removeEventListener('DOMSubtreeModified', this.refresh);\r\n }\r\n this.mutationsObserver_ = null;\r\n this.mutationEventsAdded_ = false;\r\n this.connected_ = false;\r\n };\r\n /**\r\n * \"Transitionend\" event handler.\r\n *\r\n * @private\r\n * @param {TransitionEvent} event\r\n * @returns {void}\r\n */\r\n ResizeObserverController.prototype.onTransitionEnd_ = function (_a) {\r\n var _b = _a.propertyName, propertyName = _b === void 0 ? '' : _b;\r\n // Detect whether transition may affect dimensions of an element.\r\n var isReflowProperty = transitionKeys.some(function (key) {\r\n return !!~propertyName.indexOf(key);\r\n });\r\n if (isReflowProperty) {\r\n this.refresh();\r\n }\r\n };\r\n /**\r\n * Returns instance of the ResizeObserverController.\r\n *\r\n * @returns {ResizeObserverController}\r\n */\r\n ResizeObserverController.getInstance = function () {\r\n if (!this.instance_) {\r\n this.instance_ = new ResizeObserverController();\r\n }\r\n return this.instance_;\r\n };\r\n /**\r\n * Holds reference to the controller's instance.\r\n *\r\n * @private {ResizeObserverController}\r\n */\r\n ResizeObserverController.instance_ = null;\r\n return ResizeObserverController;\r\n}());\n\n/**\r\n * Defines non-writable/enumerable properties of the provided target object.\r\n *\r\n * @param {Object} target - Object for which to define properties.\r\n * @param {Object} props - Properties to be defined.\r\n * @returns {Object} Target object.\r\n */\r\nvar defineConfigurable = (function (target, props) {\r\n for (var _i = 0, _a = Object.keys(props); _i < _a.length; _i++) {\r\n var key = _a[_i];\r\n Object.defineProperty(target, key, {\r\n value: props[key],\r\n enumerable: false,\r\n writable: false,\r\n configurable: true\r\n });\r\n }\r\n return target;\r\n});\n\n/**\r\n * Returns the global object associated with provided element.\r\n *\r\n * @param {Object} target\r\n * @returns {Object}\r\n */\r\nvar getWindowOf = (function (target) {\r\n // Assume that the element is an instance of Node, which means that it\r\n // has the \"ownerDocument\" property from which we can retrieve a\r\n // corresponding global object.\r\n var ownerGlobal = target && target.ownerDocument && target.ownerDocument.defaultView;\r\n // Return the local global object if it's not possible extract one from\r\n // provided element.\r\n return ownerGlobal || global$1;\r\n});\n\n// Placeholder of an empty content rectangle.\r\nvar emptyRect = createRectInit(0, 0, 0, 0);\r\n/**\r\n * Converts provided string to a number.\r\n *\r\n * @param {number|string} value\r\n * @returns {number}\r\n */\r\nfunction toFloat(value) {\r\n return parseFloat(value) || 0;\r\n}\r\n/**\r\n * Extracts borders size from provided styles.\r\n *\r\n * @param {CSSStyleDeclaration} styles\r\n * @param {...string} positions - Borders positions (top, right, ...)\r\n * @returns {number}\r\n */\r\nfunction getBordersSize(styles) {\r\n var positions = [];\r\n for (var _i = 1; _i < arguments.length; _i++) {\r\n positions[_i - 1] = arguments[_i];\r\n }\r\n return positions.reduce(function (size, position) {\r\n var value = styles['border-' + position + '-width'];\r\n return size + toFloat(value);\r\n }, 0);\r\n}\r\n/**\r\n * Extracts paddings sizes from provided styles.\r\n *\r\n * @param {CSSStyleDeclaration} styles\r\n * @returns {Object} Paddings box.\r\n */\r\nfunction getPaddings(styles) {\r\n var positions = ['top', 'right', 'bottom', 'left'];\r\n var paddings = {};\r\n for (var _i = 0, positions_1 = positions; _i < positions_1.length; _i++) {\r\n var position = positions_1[_i];\r\n var value = styles['padding-' + position];\r\n paddings[position] = toFloat(value);\r\n }\r\n return paddings;\r\n}\r\n/**\r\n * Calculates content rectangle of provided SVG element.\r\n *\r\n * @param {SVGGraphicsElement} target - Element content rectangle of which needs\r\n * to be calculated.\r\n * @returns {DOMRectInit}\r\n */\r\nfunction getSVGContentRect(target) {\r\n var bbox = target.getBBox();\r\n return createRectInit(0, 0, bbox.width, bbox.height);\r\n}\r\n/**\r\n * Calculates content rectangle of provided HTMLElement.\r\n *\r\n * @param {HTMLElement} target - Element for which to calculate the content rectangle.\r\n * @returns {DOMRectInit}\r\n */\r\nfunction getHTMLElementContentRect(target) {\r\n // Client width & height properties can't be\r\n // used exclusively as they provide rounded values.\r\n var clientWidth = target.clientWidth, clientHeight = target.clientHeight;\r\n // By this condition we can catch all non-replaced inline, hidden and\r\n // detached elements. Though elements with width & height properties less\r\n // than 0.5 will be discarded as well.\r\n //\r\n // Without it we would need to implement separate methods for each of\r\n // those cases and it's not possible to perform a precise and performance\r\n // effective test for hidden elements. E.g. even jQuery's ':visible' filter\r\n // gives wrong results for elements with width & height less than 0.5.\r\n if (!clientWidth && !clientHeight) {\r\n return emptyRect;\r\n }\r\n var styles = getWindowOf(target).getComputedStyle(target);\r\n var paddings = getPaddings(styles);\r\n var horizPad = paddings.left + paddings.right;\r\n var vertPad = paddings.top + paddings.bottom;\r\n // Computed styles of width & height are being used because they are the\r\n // only dimensions available to JS that contain non-rounded values. It could\r\n // be possible to utilize the getBoundingClientRect if only it's data wasn't\r\n // affected by CSS transformations let alone paddings, borders and scroll bars.\r\n var width = toFloat(styles.width), height = toFloat(styles.height);\r\n // Width & height include paddings and borders when the 'border-box' box\r\n // model is applied (except for IE).\r\n if (styles.boxSizing === 'border-box') {\r\n // Following conditions are required to handle Internet Explorer which\r\n // doesn't include paddings and borders to computed CSS dimensions.\r\n //\r\n // We can say that if CSS dimensions + paddings are equal to the \"client\"\r\n // properties then it's either IE, and thus we don't need to subtract\r\n // anything, or an element merely doesn't have paddings/borders styles.\r\n if (Math.round(width + horizPad) !== clientWidth) {\r\n width -= getBordersSize(styles, 'left', 'right') + horizPad;\r\n }\r\n if (Math.round(height + vertPad) !== clientHeight) {\r\n height -= getBordersSize(styles, 'top', 'bottom') + vertPad;\r\n }\r\n }\r\n // Following steps can't be applied to the document's root element as its\r\n // client[Width/Height] properties represent viewport area of the window.\r\n // Besides, it's as well not necessary as the itself neither has\r\n // rendered scroll bars nor it can be clipped.\r\n if (!isDocumentElement(target)) {\r\n // In some browsers (only in Firefox, actually) CSS width & height\r\n // include scroll bars size which can be removed at this step as scroll\r\n // bars are the only difference between rounded dimensions + paddings\r\n // and \"client\" properties, though that is not always true in Chrome.\r\n var vertScrollbar = Math.round(width + horizPad) - clientWidth;\r\n var horizScrollbar = Math.round(height + vertPad) - clientHeight;\r\n // Chrome has a rather weird rounding of \"client\" properties.\r\n // E.g. for an element with content width of 314.2px it sometimes gives\r\n // the client width of 315px and for the width of 314.7px it may give\r\n // 314px. And it doesn't happen all the time. So just ignore this delta\r\n // as a non-relevant.\r\n if (Math.abs(vertScrollbar) !== 1) {\r\n width -= vertScrollbar;\r\n }\r\n if (Math.abs(horizScrollbar) !== 1) {\r\n height -= horizScrollbar;\r\n }\r\n }\r\n return createRectInit(paddings.left, paddings.top, width, height);\r\n}\r\n/**\r\n * Checks whether provided element is an instance of the SVGGraphicsElement.\r\n *\r\n * @param {Element} target - Element to be checked.\r\n * @returns {boolean}\r\n */\r\nvar isSVGGraphicsElement = (function () {\r\n // Some browsers, namely IE and Edge, don't have the SVGGraphicsElement\r\n // interface.\r\n if (typeof SVGGraphicsElement !== 'undefined') {\r\n return function (target) { return target instanceof getWindowOf(target).SVGGraphicsElement; };\r\n }\r\n // If it's so, then check that element is at least an instance of the\r\n // SVGElement and that it has the \"getBBox\" method.\r\n // eslint-disable-next-line no-extra-parens\r\n return function (target) { return (target instanceof getWindowOf(target).SVGElement &&\r\n typeof target.getBBox === 'function'); };\r\n})();\r\n/**\r\n * Checks whether provided element is a document element ().\r\n *\r\n * @param {Element} target - Element to be checked.\r\n * @returns {boolean}\r\n */\r\nfunction isDocumentElement(target) {\r\n return target === getWindowOf(target).document.documentElement;\r\n}\r\n/**\r\n * Calculates an appropriate content rectangle for provided html or svg element.\r\n *\r\n * @param {Element} target - Element content rectangle of which needs to be calculated.\r\n * @returns {DOMRectInit}\r\n */\r\nfunction getContentRect(target) {\r\n if (!isBrowser) {\r\n return emptyRect;\r\n }\r\n if (isSVGGraphicsElement(target)) {\r\n return getSVGContentRect(target);\r\n }\r\n return getHTMLElementContentRect(target);\r\n}\r\n/**\r\n * Creates rectangle with an interface of the DOMRectReadOnly.\r\n * Spec: https://drafts.fxtf.org/geometry/#domrectreadonly\r\n *\r\n * @param {DOMRectInit} rectInit - Object with rectangle's x/y coordinates and dimensions.\r\n * @returns {DOMRectReadOnly}\r\n */\r\nfunction createReadOnlyRect(_a) {\r\n var x = _a.x, y = _a.y, width = _a.width, height = _a.height;\r\n // If DOMRectReadOnly is available use it as a prototype for the rectangle.\r\n var Constr = typeof DOMRectReadOnly !== 'undefined' ? DOMRectReadOnly : Object;\r\n var rect = Object.create(Constr.prototype);\r\n // Rectangle's properties are not writable and non-enumerable.\r\n defineConfigurable(rect, {\r\n x: x, y: y, width: width, height: height,\r\n top: y,\r\n right: x + width,\r\n bottom: height + y,\r\n left: x\r\n });\r\n return rect;\r\n}\r\n/**\r\n * Creates DOMRectInit object based on the provided dimensions and the x/y coordinates.\r\n * Spec: https://drafts.fxtf.org/geometry/#dictdef-domrectinit\r\n *\r\n * @param {number} x - X coordinate.\r\n * @param {number} y - Y coordinate.\r\n * @param {number} width - Rectangle's width.\r\n * @param {number} height - Rectangle's height.\r\n * @returns {DOMRectInit}\r\n */\r\nfunction createRectInit(x, y, width, height) {\r\n return { x: x, y: y, width: width, height: height };\r\n}\n\n/**\r\n * Class that is responsible for computations of the content rectangle of\r\n * provided DOM element and for keeping track of it's changes.\r\n */\r\nvar ResizeObservation = /** @class */ (function () {\r\n /**\r\n * Creates an instance of ResizeObservation.\r\n *\r\n * @param {Element} target - Element to be observed.\r\n */\r\n function ResizeObservation(target) {\r\n /**\r\n * Broadcasted width of content rectangle.\r\n *\r\n * @type {number}\r\n */\r\n this.broadcastWidth = 0;\r\n /**\r\n * Broadcasted height of content rectangle.\r\n *\r\n * @type {number}\r\n */\r\n this.broadcastHeight = 0;\r\n /**\r\n * Reference to the last observed content rectangle.\r\n *\r\n * @private {DOMRectInit}\r\n */\r\n this.contentRect_ = createRectInit(0, 0, 0, 0);\r\n this.target = target;\r\n }\r\n /**\r\n * Updates content rectangle and tells whether it's width or height properties\r\n * have changed since the last broadcast.\r\n *\r\n * @returns {boolean}\r\n */\r\n ResizeObservation.prototype.isActive = function () {\r\n var rect = getContentRect(this.target);\r\n this.contentRect_ = rect;\r\n return (rect.width !== this.broadcastWidth ||\r\n rect.height !== this.broadcastHeight);\r\n };\r\n /**\r\n * Updates 'broadcastWidth' and 'broadcastHeight' properties with a data\r\n * from the corresponding properties of the last observed content rectangle.\r\n *\r\n * @returns {DOMRectInit} Last observed content rectangle.\r\n */\r\n ResizeObservation.prototype.broadcastRect = function () {\r\n var rect = this.contentRect_;\r\n this.broadcastWidth = rect.width;\r\n this.broadcastHeight = rect.height;\r\n return rect;\r\n };\r\n return ResizeObservation;\r\n}());\n\nvar ResizeObserverEntry = /** @class */ (function () {\r\n /**\r\n * Creates an instance of ResizeObserverEntry.\r\n *\r\n * @param {Element} target - Element that is being observed.\r\n * @param {DOMRectInit} rectInit - Data of the element's content rectangle.\r\n */\r\n function ResizeObserverEntry(target, rectInit) {\r\n var contentRect = createReadOnlyRect(rectInit);\r\n // According to the specification following properties are not writable\r\n // and are also not enumerable in the native implementation.\r\n //\r\n // Property accessors are not being used as they'd require to define a\r\n // private WeakMap storage which may cause memory leaks in browsers that\r\n // don't support this type of collections.\r\n defineConfigurable(this, { target: target, contentRect: contentRect });\r\n }\r\n return ResizeObserverEntry;\r\n}());\n\nvar ResizeObserverSPI = /** @class */ (function () {\r\n /**\r\n * Creates a new instance of ResizeObserver.\r\n *\r\n * @param {ResizeObserverCallback} callback - Callback function that is invoked\r\n * when one of the observed elements changes it's content dimensions.\r\n * @param {ResizeObserverController} controller - Controller instance which\r\n * is responsible for the updates of observer.\r\n * @param {ResizeObserver} callbackCtx - Reference to the public\r\n * ResizeObserver instance which will be passed to callback function.\r\n */\r\n function ResizeObserverSPI(callback, controller, callbackCtx) {\r\n /**\r\n * Collection of resize observations that have detected changes in dimensions\r\n * of elements.\r\n *\r\n * @private {Array}\r\n */\r\n this.activeObservations_ = [];\r\n /**\r\n * Registry of the ResizeObservation instances.\r\n *\r\n * @private {Map}\r\n */\r\n this.observations_ = new MapShim();\r\n if (typeof callback !== 'function') {\r\n throw new TypeError('The callback provided as parameter 1 is not a function.');\r\n }\r\n this.callback_ = callback;\r\n this.controller_ = controller;\r\n this.callbackCtx_ = callbackCtx;\r\n }\r\n /**\r\n * Starts observing provided element.\r\n *\r\n * @param {Element} target - Element to be observed.\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.observe = function (target) {\r\n if (!arguments.length) {\r\n throw new TypeError('1 argument required, but only 0 present.');\r\n }\r\n // Do nothing if current environment doesn't have the Element interface.\r\n if (typeof Element === 'undefined' || !(Element instanceof Object)) {\r\n return;\r\n }\r\n if (!(target instanceof getWindowOf(target).Element)) {\r\n throw new TypeError('parameter 1 is not of type \"Element\".');\r\n }\r\n var observations = this.observations_;\r\n // Do nothing if element is already being observed.\r\n if (observations.has(target)) {\r\n return;\r\n }\r\n observations.set(target, new ResizeObservation(target));\r\n this.controller_.addObserver(this);\r\n // Force the update of observations.\r\n this.controller_.refresh();\r\n };\r\n /**\r\n * Stops observing provided element.\r\n *\r\n * @param {Element} target - Element to stop observing.\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.unobserve = function (target) {\r\n if (!arguments.length) {\r\n throw new TypeError('1 argument required, but only 0 present.');\r\n }\r\n // Do nothing if current environment doesn't have the Element interface.\r\n if (typeof Element === 'undefined' || !(Element instanceof Object)) {\r\n return;\r\n }\r\n if (!(target instanceof getWindowOf(target).Element)) {\r\n throw new TypeError('parameter 1 is not of type \"Element\".');\r\n }\r\n var observations = this.observations_;\r\n // Do nothing if element is not being observed.\r\n if (!observations.has(target)) {\r\n return;\r\n }\r\n observations.delete(target);\r\n if (!observations.size) {\r\n this.controller_.removeObserver(this);\r\n }\r\n };\r\n /**\r\n * Stops observing all elements.\r\n *\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.disconnect = function () {\r\n this.clearActive();\r\n this.observations_.clear();\r\n this.controller_.removeObserver(this);\r\n };\r\n /**\r\n * Collects observation instances the associated element of which has changed\r\n * it's content rectangle.\r\n *\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.gatherActive = function () {\r\n var _this = this;\r\n this.clearActive();\r\n this.observations_.forEach(function (observation) {\r\n if (observation.isActive()) {\r\n _this.activeObservations_.push(observation);\r\n }\r\n });\r\n };\r\n /**\r\n * Invokes initial callback function with a list of ResizeObserverEntry\r\n * instances collected from active resize observations.\r\n *\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.broadcastActive = function () {\r\n // Do nothing if observer doesn't have active observations.\r\n if (!this.hasActive()) {\r\n return;\r\n }\r\n var ctx = this.callbackCtx_;\r\n // Create ResizeObserverEntry instance for every active observation.\r\n var entries = this.activeObservations_.map(function (observation) {\r\n return new ResizeObserverEntry(observation.target, observation.broadcastRect());\r\n });\r\n this.callback_.call(ctx, entries, ctx);\r\n this.clearActive();\r\n };\r\n /**\r\n * Clears the collection of active observations.\r\n *\r\n * @returns {void}\r\n */\r\n ResizeObserverSPI.prototype.clearActive = function () {\r\n this.activeObservations_.splice(0);\r\n };\r\n /**\r\n * Tells whether observer has active observations.\r\n *\r\n * @returns {boolean}\r\n */\r\n ResizeObserverSPI.prototype.hasActive = function () {\r\n return this.activeObservations_.length > 0;\r\n };\r\n return ResizeObserverSPI;\r\n}());\n\n// Registry of internal observers. If WeakMap is not available use current shim\r\n// for the Map collection as it has all required methods and because WeakMap\r\n// can't be fully polyfilled anyway.\r\nvar observers = typeof WeakMap !== 'undefined' ? new WeakMap() : new MapShim();\r\n/**\r\n * ResizeObserver API. Encapsulates the ResizeObserver SPI implementation\r\n * exposing only those methods and properties that are defined in the spec.\r\n */\r\nvar ResizeObserver = /** @class */ (function () {\r\n /**\r\n * Creates a new instance of ResizeObserver.\r\n *\r\n * @param {ResizeObserverCallback} callback - Callback that is invoked when\r\n * dimensions of the observed elements change.\r\n */\r\n function ResizeObserver(callback) {\r\n if (!(this instanceof ResizeObserver)) {\r\n throw new TypeError('Cannot call a class as a function.');\r\n }\r\n if (!arguments.length) {\r\n throw new TypeError('1 argument required, but only 0 present.');\r\n }\r\n var controller = ResizeObserverController.getInstance();\r\n var observer = new ResizeObserverSPI(callback, controller, this);\r\n observers.set(this, observer);\r\n }\r\n return ResizeObserver;\r\n}());\r\n// Expose public methods of ResizeObserver.\r\n[\r\n 'observe',\r\n 'unobserve',\r\n 'disconnect'\r\n].forEach(function (method) {\r\n ResizeObserver.prototype[method] = function () {\r\n var _a;\r\n return (_a = observers.get(this))[method].apply(_a, arguments);\r\n };\r\n});\n\nvar index = (function () {\r\n // Export existing implementation if available.\r\n if (typeof global$1.ResizeObserver !== 'undefined') {\r\n return global$1.ResizeObserver;\r\n }\r\n return ResizeObserver;\r\n})();\n\nexport default index;\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ResizeObserver from \"resize-observer-polyfill\"\nimport {\n NEVER,\n Observable,\n Subject,\n defer,\n filter,\n finalize,\n map,\n merge,\n of,\n shareReplay,\n startWith,\n switchMap,\n tap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Element offset\n */\nexport interface ElementSize {\n width: number /* Element width */\n height: number /* Element height */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Resize observer entry subject\n */\nconst entry$ = new Subject()\n\n/**\n * Resize observer observable\n *\n * This observable will create a `ResizeObserver` on the first subscription\n * and will automatically terminate it when there are no more subscribers.\n * It's quite important to centralize observation in a single `ResizeObserver`,\n * as the performance difference can be quite dramatic, as the link shows.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n new ResizeObserver(entries => {\n for (const entry of entries)\n entry$.next(entry)\n })\n))\n .pipe(\n switchMap(observer => merge(NEVER, of(observer))\n .pipe(\n finalize(() => observer.disconnect())\n )\n ),\n shareReplay(1)\n )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element size\n *\n * @param el - Element\n *\n * @returns Element size\n */\nexport function getElementSize(\n el: HTMLElement\n): ElementSize {\n return {\n width: el.offsetWidth,\n height: el.offsetHeight\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch element size\n *\n * This function returns an observable that subscribes to a single internal\n * instance of `ResizeObserver` upon subscription, and emit resize events until\n * termination. Note that this function should not be called with the same\n * element twice, as the first unsubscription will terminate observation.\n *\n * Sadly, we can't use the `DOMRect` objects returned by the observer, because\n * we need the emitted values to be consistent with `getElementSize`, which will\n * return the used values (rounded) and not actual values (unrounded). Thus, we\n * use the `offset*` properties. See the linked GitHub issue.\n *\n * @see https://bit.ly/3m0k3he - GitHub issue\n *\n * @param el - Element\n *\n * @returns Element size observable\n */\nexport function watchElementSize(\n el: HTMLElement\n): Observable {\n return observer$\n .pipe(\n tap(observer => observer.observe(el)),\n switchMap(observer => entry$\n .pipe(\n filter(({ target }) => target === el),\n finalize(() => observer.unobserve(el)),\n map(() => getElementSize(el))\n )\n ),\n startWith(getElementSize(el))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ElementSize } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve element content size (= scroll width and height)\n *\n * @param el - Element\n *\n * @returns Element content size\n */\nexport function getElementContentSize(\n el: HTMLElement\n): ElementSize {\n return {\n width: el.scrollWidth,\n height: el.scrollHeight\n }\n}\n\n/**\n * Retrieve the overflowing container of an element, if any\n *\n * @param el - Element\n *\n * @returns Overflowing container or nothing\n */\nexport function getElementContainer(\n el: HTMLElement\n): HTMLElement | undefined {\n let parent = el.parentElement\n while (parent)\n if (\n el.scrollWidth <= parent.scrollWidth &&\n el.scrollHeight <= parent.scrollHeight\n )\n parent = (el = parent).parentElement\n else\n break\n\n /* Return overflowing container */\n return parent ? el : undefined\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n NEVER,\n Observable,\n Subject,\n defer,\n distinctUntilChanged,\n filter,\n finalize,\n map,\n merge,\n of,\n shareReplay,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport {\n getElementContentSize,\n getElementSize,\n watchElementContentOffset\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Intersection observer entry subject\n */\nconst entry$ = new Subject()\n\n/**\n * Intersection observer observable\n *\n * This observable will create an `IntersectionObserver` on first subscription\n * and will automatically terminate it when there are no more subscribers.\n *\n * @see https://bit.ly/3iIYfEm - Google Groups on performance\n */\nconst observer$ = defer(() => of(\n new IntersectionObserver(entries => {\n for (const entry of entries)\n entry$.next(entry)\n }, {\n threshold: 0\n })\n))\n .pipe(\n switchMap(observer => merge(NEVER, of(observer))\n .pipe(\n finalize(() => observer.disconnect())\n )\n ),\n shareReplay(1)\n )\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch element visibility\n *\n * @param el - Element\n *\n * @returns Element visibility observable\n */\nexport function watchElementVisibility(\n el: HTMLElement\n): Observable {\n return observer$\n .pipe(\n tap(observer => observer.observe(el)),\n switchMap(observer => entry$\n .pipe(\n filter(({ target }) => target === el),\n finalize(() => observer.unobserve(el)),\n map(({ isIntersecting }) => isIntersecting)\n )\n )\n )\n}\n\n/**\n * Watch element boundary\n *\n * This function returns an observable which emits whether the bottom content\n * boundary (= scroll offset) of an element is within a certain threshold.\n *\n * @param el - Element\n * @param threshold - Threshold\n *\n * @returns Element boundary observable\n */\nexport function watchElementBoundary(\n el: HTMLElement, threshold = 16\n): Observable {\n return watchElementContentOffset(el)\n .pipe(\n map(({ y }) => {\n const visible = getElementSize(el)\n const content = getElementContentSize(el)\n return y >= (\n content.height - visible.height - threshold\n )\n }),\n distinctUntilChanged()\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n startWith\n} from \"rxjs\"\n\nimport { getElement } from \"../element\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle\n */\nexport type Toggle =\n | \"drawer\" /* Toggle for drawer */\n | \"search\" /* Toggle for search */\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Toggle map\n */\nconst toggles: Record = {\n drawer: getElement(\"[data-md-toggle=drawer]\"),\n search: getElement(\"[data-md-toggle=search]\")\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the value of a toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value\n */\nexport function getToggle(name: Toggle): boolean {\n return toggles[name].checked\n}\n\n/**\n * Set toggle\n *\n * Simulating a click event seems to be the most cross-browser compatible way\n * of changing the value while also emitting a `change` event. Before, Material\n * used `CustomEvent` to programmatically change the value of a toggle, but this\n * is a much simpler and cleaner solution which doesn't require a polyfill.\n *\n * @param name - Toggle\n * @param value - Toggle value\n */\nexport function setToggle(name: Toggle, value: boolean): void {\n if (toggles[name].checked !== value)\n toggles[name].click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch toggle\n *\n * @param name - Toggle\n *\n * @returns Toggle value observable\n */\nexport function watchToggle(name: Toggle): Observable {\n const el = toggles[name]\n return fromEvent(el, \"change\")\n .pipe(\n map(() => el.checked),\n startWith(el.checked)\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n map,\n share\n} from \"rxjs\"\n\nimport { getActiveElement } from \"../element\"\nimport { getToggle } from \"../toggle\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Keyboard mode\n */\nexport type KeyboardMode =\n | \"global\" /* Global */\n | \"search\" /* Search is open */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Keyboard\n */\nexport interface Keyboard {\n mode: KeyboardMode /* Keyboard mode */\n type: string /* Key type */\n claim(): void /* Key claim */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether an element may receive keyboard input\n *\n * @param el - Element\n * @param type - Key type\n *\n * @returns Test result\n */\nfunction isSusceptibleToKeyboard(\n el: HTMLElement, type: string\n): boolean {\n switch (el.constructor) {\n\n /* Input elements */\n case HTMLInputElement:\n /* @ts-expect-error - omit unnecessary type cast */\n if (el.type === \"radio\")\n return /^Arrow/.test(type)\n else\n return true\n\n /* Select element and textarea */\n case HTMLSelectElement:\n case HTMLTextAreaElement:\n return true\n\n /* Everything else */\n default:\n return el.isContentEditable\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch keyboard\n *\n * @returns Keyboard observable\n */\nexport function watchKeyboard(): Observable {\n return fromEvent(window, \"keydown\")\n .pipe(\n filter(ev => !(ev.metaKey || ev.ctrlKey)),\n map(ev => ({\n mode: getToggle(\"search\") ? \"search\" : \"global\",\n type: ev.key,\n claim() {\n ev.preventDefault()\n ev.stopPropagation()\n }\n } as Keyboard)),\n filter(({ mode, type }) => {\n if (mode === \"global\") {\n const active = getActiveElement()\n if (typeof active !== \"undefined\")\n return !isSusceptibleToKeyboard(active, type)\n }\n return true\n }),\n share()\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Subject } from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location\n *\n * This function returns a `URL` object (and not `Location`) to normalize the\n * typings across the application. Furthermore, locations need to be tracked\n * without setting them and `Location` is a singleton which represents the\n * current location.\n *\n * @returns URL\n */\nexport function getLocation(): URL {\n return new URL(location.href)\n}\n\n/**\n * Set location\n *\n * @param url - URL to change to\n */\nexport function setLocation(url: URL): void {\n location.href = url.href\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location\n *\n * @returns Location subject\n */\nexport function watchLocation(): Subject {\n return new Subject()\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { JSX as JSXInternal } from \"preact\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * HTML attributes\n */\ntype Attributes =\n & JSXInternal.HTMLAttributes\n & JSXInternal.SVGAttributes\n & Record\n\n/**\n * Child element\n */\ntype Child =\n | HTMLElement\n | Text\n | string\n | number\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Append a child node to an element\n *\n * @param el - Element\n * @param child - Child node(s)\n */\nfunction appendChild(el: HTMLElement, child: Child | Child[]): void {\n\n /* Handle primitive types (including raw HTML) */\n if (typeof child === \"string\" || typeof child === \"number\") {\n el.innerHTML += child.toString()\n\n /* Handle nodes */\n } else if (child instanceof Node) {\n el.appendChild(child)\n\n /* Handle nested children */\n } else if (Array.isArray(child)) {\n for (const node of child)\n appendChild(el, node)\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * JSX factory\n *\n * @template T - Element type\n *\n * @param tag - HTML tag\n * @param attributes - HTML attributes\n * @param children - Child elements\n *\n * @returns Element\n */\nexport function h(\n tag: T, attributes?: Attributes | null, ...children: Child[]\n): HTMLElementTagNameMap[T]\n\nexport function h(\n tag: string, attributes?: Attributes | null, ...children: Child[]\n): T\n\nexport function h(\n tag: string, attributes?: Attributes | null, ...children: Child[]\n): T {\n const el = document.createElement(tag)\n\n /* Set attributes, if any */\n if (attributes)\n for (const attr of Object.keys(attributes)) {\n if (typeof attributes[attr] === \"undefined\")\n continue\n\n /* Set default attribute or boolean */\n if (typeof attributes[attr] !== \"boolean\")\n el.setAttribute(attr, attributes[attr])\n else\n el.setAttribute(attr, \"\")\n }\n\n /* Append child nodes */\n for (const child of children)\n appendChild(el, child)\n\n /* Return element */\n return el as T\n}\n\n/* ----------------------------------------------------------------------------\n * Namespace\n * ------------------------------------------------------------------------- */\n\nexport declare namespace h {\n namespace JSX {\n type Element = HTMLElement\n type IntrinsicElements = JSXInternal.IntrinsicElements\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Truncate a string after the given number of characters\n *\n * This is not a very reasonable approach, since the summaries kind of suck.\n * It would be better to create something more intelligent, highlighting the\n * search occurrences and making a better summary out of it, but this note was\n * written three years ago, so who knows if we'll ever fix it.\n *\n * @param value - Value to be truncated\n * @param n - Number of characters\n *\n * @returns Truncated value\n */\nexport function truncate(value: string, n: number): string {\n let i = n\n if (value.length > i) {\n while (value[i] !== \" \" && --i > 0) { /* keep eating */ }\n return `${value.substring(0, i)}...`\n }\n return value\n}\n\n/**\n * Round a number for display with repository facts\n *\n * This is a reverse-engineered version of GitHub's weird rounding algorithm\n * for stars, forks and all other numbers. While all numbers below `1,000` are\n * returned as-is, bigger numbers are converted to fixed numbers:\n *\n * - `1,049` => `1k`\n * - `1,050` => `1.1k`\n * - `1,949` => `1.9k`\n * - `1,950` => `2k`\n *\n * @param value - Original value\n *\n * @returns Rounded value\n */\nexport function round(value: number): string {\n if (value > 999) {\n const digits = +((value - 950) % 1000 > 99)\n return `${((value + 0.000001) / 1000).toFixed(digits)}k`\n } else {\n return value.toString()\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n map,\n shareReplay,\n startWith\n} from \"rxjs\"\n\nimport { getOptionalElement } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve location hash\n *\n * @returns Location hash\n */\nexport function getLocationHash(): string {\n return location.hash.substring(1)\n}\n\n/**\n * Set location hash\n *\n * Setting a new fragment identifier via `location.hash` will have no effect\n * if the value doesn't change. When a new fragment identifier is set, we want\n * the browser to target the respective element at all times, which is why we\n * use this dirty little trick.\n *\n * @param hash - Location hash\n */\nexport function setLocationHash(hash: string): void {\n const el = h(\"a\", { href: hash })\n el.addEventListener(\"click\", ev => ev.stopPropagation())\n el.click()\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch location hash\n *\n * @returns Location hash observable\n */\nexport function watchLocationHash(): Observable {\n return fromEvent(window, \"hashchange\")\n .pipe(\n map(getLocationHash),\n startWith(getLocationHash()),\n filter(hash => hash.length > 0),\n shareReplay(1)\n )\n}\n\n/**\n * Watch location target\n *\n * @returns Location target observable\n */\nexport function watchLocationTarget(): Observable {\n return watchLocationHash()\n .pipe(\n map(id => getOptionalElement(`[id=\"${id}\"]`)!),\n filter(el => typeof el !== \"undefined\")\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n fromEvent,\n fromEventPattern,\n map,\n merge,\n startWith,\n switchMap\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch media query\n *\n * Note that although `MediaQueryList.addListener` is deprecated we have to\n * use it, because it's the only way to ensure proper downward compatibility.\n *\n * @see https://bit.ly/3dUBH2m - GitHub issue\n *\n * @param query - Media query\n *\n * @returns Media observable\n */\nexport function watchMedia(query: string): Observable {\n const media = matchMedia(query)\n return fromEventPattern(next => (\n media.addListener(() => next(media.matches))\n ))\n .pipe(\n startWith(media.matches)\n )\n}\n\n/**\n * Watch print mode\n *\n * @returns Print observable\n */\nexport function watchPrint(): Observable {\n const media = matchMedia(\"print\")\n return merge(\n fromEvent(window, \"beforeprint\").pipe(map(() => true)),\n fromEvent(window, \"afterprint\").pipe(map(() => false))\n )\n .pipe(\n startWith(media.matches)\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Toggle an observable with a media observable\n *\n * @template T - Data type\n *\n * @param query$ - Media observable\n * @param factory - Observable factory\n *\n * @returns Toggled observable\n */\nexport function at(\n query$: Observable, factory: () => Observable\n): Observable {\n return query$\n .pipe(\n switchMap(active => active ? factory() : EMPTY)\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n catchError,\n from,\n map,\n of,\n shareReplay,\n switchMap,\n throwError\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the given URL\n *\n * If the request fails (e.g. when dispatched from `file://` locations), the\n * observable will complete without emitting a value.\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Response observable\n */\nexport function request(\n url: URL | string, options: RequestInit = { credentials: \"same-origin\" }\n): Observable {\n return from(fetch(`${url}`, options))\n .pipe(\n catchError(() => EMPTY),\n switchMap(res => res.status !== 200\n ? throwError(() => new Error(res.statusText))\n : of(res)\n )\n )\n}\n\n/**\n * Fetch JSON from the given URL\n *\n * @template T - Data type\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestJSON(\n url: URL | string, options?: RequestInit\n): Observable {\n return request(url, options)\n .pipe(\n switchMap(res => res.json()),\n shareReplay(1)\n )\n}\n\n/**\n * Fetch XML from the given URL\n *\n * @param url - Request URL\n * @param options - Options\n *\n * @returns Data observable\n */\nexport function requestXML(\n url: URL | string, options?: RequestInit\n): Observable {\n const dom = new DOMParser()\n return request(url, options)\n .pipe(\n switchMap(res => res.text()),\n map(res => dom.parseFromString(res, \"text/xml\")),\n shareReplay(1)\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n defer,\n finalize,\n fromEvent,\n map,\n merge,\n switchMap,\n take,\n throwError\n} from \"rxjs\"\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create and load a `script` element\n *\n * This function returns an observable that will emit when the script was\n * successfully loaded, or throw an error if it didn't.\n *\n * @param src - Script URL\n *\n * @returns Script observable\n */\nexport function watchScript(src: string): Observable {\n const script = h(\"script\", { src })\n return defer(() => {\n document.head.appendChild(script)\n return merge(\n fromEvent(script, \"load\"),\n fromEvent(script, \"error\")\n .pipe(\n switchMap(() => (\n throwError(() => new ReferenceError(`Invalid script: ${src}`))\n ))\n )\n )\n .pipe(\n map(() => undefined),\n finalize(() => document.head.removeChild(script)),\n take(1)\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n merge,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport offset\n */\nexport interface ViewportOffset {\n x: number /* Horizontal offset */\n y: number /* Vertical offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport offset\n *\n * On iOS Safari, viewport offset can be negative due to overflow scrolling.\n * As this may induce strange behaviors downstream, we'll just limit it to 0.\n *\n * @returns Viewport offset\n */\nexport function getViewportOffset(): ViewportOffset {\n return {\n x: Math.max(0, scrollX),\n y: Math.max(0, scrollY)\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport offset\n *\n * @returns Viewport offset observable\n */\nexport function watchViewportOffset(): Observable {\n return merge(\n fromEvent(window, \"scroll\", { passive: true }),\n fromEvent(window, \"resize\", { passive: true })\n )\n .pipe(\n map(getViewportOffset),\n startWith(getViewportOffset())\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n startWith\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport size\n */\nexport interface ViewportSize {\n width: number /* Viewport width */\n height: number /* Viewport height */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve viewport size\n *\n * @returns Viewport size\n */\nexport function getViewportSize(): ViewportSize {\n return {\n width: innerWidth,\n height: innerHeight\n }\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport size\n *\n * @returns Viewport size observable\n */\nexport function watchViewportSize(): Observable {\n return fromEvent(window, \"resize\", { passive: true })\n .pipe(\n map(getViewportSize),\n startWith(getViewportSize())\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n map,\n shareReplay\n} from \"rxjs\"\n\nimport {\n ViewportOffset,\n watchViewportOffset\n} from \"../offset\"\nimport {\n ViewportSize,\n watchViewportSize\n} from \"../size\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Viewport\n */\nexport interface Viewport {\n offset: ViewportOffset /* Viewport offset */\n size: ViewportSize /* Viewport size */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport\n *\n * @returns Viewport observable\n */\nexport function watchViewport(): Observable {\n return combineLatest([\n watchViewportOffset(),\n watchViewportSize()\n ])\n .pipe(\n map(([offset, size]) => ({ offset, size })),\n shareReplay(1)\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n distinctUntilKeyChanged,\n map\n} from \"rxjs\"\n\nimport { Header } from \"~/components\"\n\nimport { getElementOffset } from \"../../element\"\nimport { Viewport } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
/* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch viewport relative to element\n *\n * @param el - Element\n * @param options - Options\n *\n * @returns Viewport observable\n */\nexport function watchViewportAt(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n const size$ = viewport$\n .pipe(\n distinctUntilKeyChanged(\"size\")\n )\n\n /* Compute element offset */\n const offset$ = combineLatest([size$, header$])\n .pipe(\n map(() => getElementOffset(el))\n )\n\n /* Compute relative viewport, return hot observable */\n return combineLatest([header$, viewport$, offset$])\n .pipe(\n map(([{ height }, { offset, size }, { x, y }]) => ({\n offset: {\n x: offset.x - x,\n y: offset.y - y + height\n },\n size\n }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n fromEvent,\n map,\n share,\n switchMap,\n tap,\n throttle\n} from \"rxjs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Worker message\n */\nexport interface WorkerMessage {\n type: unknown /* Message type */\n data?: unknown /* Message data */\n}\n\n/**\n * Worker handler\n *\n * @template T - Message type\n */\nexport interface WorkerHandler<\n T extends WorkerMessage\n> {\n tx$: Subject /* Message transmission subject */\n rx$: Observable /* Message receive observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n *\n * @template T - Worker message type\n */\ninterface WatchOptions {\n tx$: Observable /* Message transmission observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch a web worker\n *\n * This function returns an observable that sends all values emitted by the\n * message observable to the web worker. Web worker communication is expected\n * to be bidirectional (request-response) and synchronous. Messages that are\n * emitted during a pending request are throttled, the last one is emitted.\n *\n * @param worker - Web worker\n * @param options - Options\n *\n * @returns Worker message observable\n */\nexport function watchWorker(\n worker: Worker, { tx$ }: WatchOptions\n): Observable {\n\n /* Intercept messages from worker-like objects */\n const rx$ = fromEvent(worker, \"message\")\n .pipe(\n map(({ data }) => data as T)\n )\n\n /* Send and receive messages, return hot observable */\n return tx$\n .pipe(\n throttle(() => rx$, { leading: true, trailing: true }),\n tap(message => worker.postMessage(message)),\n switchMap(() => rx$),\n share()\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getLocation } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Feature flag\n */\nexport type Flag =\n | \"announce.dismiss\" /* Dismissable announcement bar */\n | \"content.code.annotate\" /* Code annotations */\n | \"content.lazy\" /* Lazy content elements */\n | \"content.tabs.link\" /* Link content tabs */\n | \"header.autohide\" /* Hide header */\n | \"navigation.expand\" /* Automatic expansion */\n | \"navigation.indexes\" /* Section pages */\n | \"navigation.instant\" /* Instant loading */\n | \"navigation.sections\" /* Section navigation */\n | \"navigation.tabs\" /* Tabs navigation */\n | \"navigation.tabs.sticky\" /* Tabs navigation (sticky) */\n | \"navigation.top\" /* Back-to-top button */\n | \"navigation.tracking\" /* Anchor tracking */\n | \"search.highlight\" /* Search highlighting */\n | \"search.share\" /* Search sharing */\n | \"search.suggest\" /* Search suggestions */\n | \"toc.follow\" /* Following table of contents */\n | \"toc.integrate\" /* Integrated table of contents */\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Translation\n */\nexport type Translation =\n | \"clipboard.copy\" /* Copy to clipboard */\n | \"clipboard.copied\" /* Copied to clipboard */\n | \"search.config.lang\" /* Search language */\n | \"search.config.pipeline\" /* Search pipeline */\n | \"search.config.separator\" /* Search separator */\n | \"search.placeholder\" /* Search */\n | \"search.result.placeholder\" /* Type to start searching */\n | \"search.result.none\" /* No matching documents */\n | \"search.result.one\" /* 1 matching document */\n | \"search.result.other\" /* # matching documents */\n | \"search.result.more.one\" /* 1 more on this page */\n | \"search.result.more.other\" /* # more on this page */\n | \"search.result.term.missing\" /* Missing */\n | \"select.version.title\" /* Version selector */\n\n/**\n * Translations\n */\nexport type Translations = Record\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Versioning\n */\nexport interface Versioning {\n provider: \"mike\" /* Version provider */\n default?: string /* Default version */\n}\n\n/**\n * Configuration\n */\nexport interface Config {\n base: string /* Base URL */\n features: Flag[] /* Feature flags */\n translations: Translations /* Translations */\n search: string /* Search worker URL */\n tags?: Record /* Tags mapping */\n version?: Versioning /* Versioning */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration and make base URL absolute\n */\nconst script = getElement(\"#__config\")\nconst config: Config = JSON.parse(script.textContent!)\nconfig.base = `${new URL(config.base, getLocation())}`\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve global configuration\n *\n * @returns Global configuration\n */\nexport function configuration(): Config {\n return config\n}\n\n/**\n * Check whether a feature flag is enabled\n *\n * @param flag - Feature flag\n *\n * @returns Test result\n */\nexport function feature(flag: Flag): boolean {\n return config.features.includes(flag)\n}\n\n/**\n * Retrieve the translation for the given key\n *\n * @param key - Key to be translated\n * @param value - Positional value, if any\n *\n * @returns Translation\n */\nexport function translation(\n key: Translation, value?: string | number\n): string {\n return typeof value !== \"undefined\"\n ? config.translations[key].replace(\"#\", value.toString())\n : config.translations[key]\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { getElement, getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type\n */\nexport type ComponentType =\n | \"announce\" /* Announcement bar */\n | \"container\" /* Container */\n | \"consent\" /* Consent */\n | \"content\" /* Content */\n | \"dialog\" /* Dialog */\n | \"header\" /* Header */\n | \"header-title\" /* Header title */\n | \"header-topic\" /* Header topic */\n | \"main\" /* Main area */\n | \"outdated\" /* Version warning */\n | \"palette\" /* Color palette */\n | \"search\" /* Search */\n | \"search-query\" /* Search input */\n | \"search-result\" /* Search results */\n | \"search-share\" /* Search sharing */\n | \"search-suggest\" /* Search suggestions */\n | \"sidebar\" /* Sidebar */\n | \"skip\" /* Skip link */\n | \"source\" /* Repository information */\n | \"tabs\" /* Navigation tabs */\n | \"toc\" /* Table of contents */\n | \"top\" /* Back-to-top button */\n\n/**\n * Component\n *\n * @template T - Component type\n * @template U - Reference type\n */\nexport type Component<\n T extends {} = {},\n U extends HTMLElement = HTMLElement\n> =\n T & {\n ref: U /* Component reference */\n }\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Component type map\n */\ninterface ComponentTypeMap {\n \"announce\": HTMLElement /* Announcement bar */\n \"container\": HTMLElement /* Container */\n \"consent\": HTMLElement /* Consent */\n \"content\": HTMLElement /* Content */\n \"dialog\": HTMLElement /* Dialog */\n \"header\": HTMLElement /* Header */\n \"header-title\": HTMLElement /* Header title */\n \"header-topic\": HTMLElement /* Header topic */\n \"main\": HTMLElement /* Main area */\n \"outdated\": HTMLElement /* Version warning */\n \"palette\": HTMLElement /* Color palette */\n \"search\": HTMLElement /* Search */\n \"search-query\": HTMLInputElement /* Search input */\n \"search-result\": HTMLElement /* Search results */\n \"search-share\": HTMLAnchorElement /* Search sharing */\n \"search-suggest\": HTMLElement /* Search suggestions */\n \"sidebar\": HTMLElement /* Sidebar */\n \"skip\": HTMLAnchorElement /* Skip link */\n \"source\": HTMLAnchorElement /* Repository information */\n \"tabs\": HTMLElement /* Navigation tabs */\n \"toc\": HTMLElement /* Table of contents */\n \"top\": HTMLAnchorElement /* Back-to-top button */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Retrieve the element for a given component or throw a reference error\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Element\n */\nexport function getComponentElement(\n type: T, node: ParentNode = document\n): ComponentTypeMap[T] {\n return getElement(`[data-md-component=${type}]`, node)\n}\n\n/**\n * Retrieve all elements for a given component\n *\n * @template T - Component type\n *\n * @param type - Component type\n * @param node - Node of reference\n *\n * @returns Elements\n */\nexport function getComponentElements(\n type: T, node: ParentNode = document\n): ComponentTypeMap[T][] {\n return getElements(`[data-md-component=${type}]`, node)\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n finalize,\n fromEvent,\n map,\n startWith,\n tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Announcement bar\n */\nexport interface Announce {\n hash: number /* Content hash */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar observable\n */\nexport function watchAnnounce(\n el: HTMLElement\n): Observable {\n const button = getElement(\".md-typeset > :first-child\", el)\n return fromEvent(button, \"click\", { once: true })\n .pipe(\n map(() => getElement(\".md-typeset\", el)),\n map(content => ({ hash: __md_hash(content.innerHTML) }))\n )\n}\n\n/**\n * Mount announcement bar\n *\n * @param el - Announcement bar element\n *\n * @returns Announcement bar component observable\n */\nexport function mountAnnounce(\n el: HTMLElement\n): Observable> {\n if (!feature(\"announce.dismiss\") || !el.childElementCount)\n return EMPTY\n\n /* Mount component on subscription */\n return defer(() => {\n const push$ = new Subject()\n push$\n .pipe(\n startWith({ hash: __md_get(\"__announce\") })\n )\n .subscribe(({ hash }) => {\n if (hash && hash === (__md_get(\"__announce\") ?? hash)) {\n el.hidden = true\n\n /* Persist preference in local storage */\n __md_set(\"__announce\", hash)\n }\n })\n\n /* Create and return component */\n return watchAnnounce(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n finalize,\n map,\n tap\n} from \"rxjs\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Consent\n */\nexport interface Consent {\n hidden: boolean /* Consent is hidden */\n}\n\n/**\n * Consent defaults\n */\nexport interface ConsentDefaults {\n analytics?: boolean /* Consent for Analytics */\n github?: boolean /* Consent for GitHub */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n target$: Observable /* Target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent observable\n */\nexport function watchConsent(\n el: HTMLElement, { target$ }: WatchOptions\n): Observable {\n return target$\n .pipe(\n map(target => ({ hidden: target !== el }))\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount consent\n *\n * @param el - Consent element\n * @param options - Options\n *\n * @returns Consent component observable\n */\nexport function mountConsent(\n el: HTMLElement, options: MountOptions\n): Observable> {\n const internal$ = new Subject()\n internal$.subscribe(({ hidden }) => {\n el.hidden = hidden\n })\n\n /* Create and return component */\n return watchConsent(el, options)\n .pipe(\n tap(state => internal$.next(state)),\n finalize(() => internal$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n finalize,\n map,\n mergeWith,\n switchMap,\n take,\n tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n getElementContentSize,\n watchElementSize,\n watchElementVisibility\n} from \"~/browser\"\nimport { renderClipboardButton } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n Annotation,\n mountAnnotationList\n} from \"../../annotation\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Code block\n */\nexport interface CodeBlock {\n scrollable: boolean /* Code block overflows */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Global sequence number for code blocks\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find candidate list element directly following a code block\n *\n * @param el - Code block element\n *\n * @returns List element or nothing\n */\nfunction findCandidateList(el: HTMLElement): HTMLElement | undefined {\n if (el.nextElementSibling) {\n const sibling = el.nextElementSibling as HTMLElement\n if (sibling.tagName === \"OL\")\n return sibling\n\n /* Skip empty paragraphs - see https://bit.ly/3r4ZJ2O */\n else if (sibling.tagName === \"P\" && !sibling.children.length)\n return findCandidateList(sibling)\n }\n\n /* Everything else */\n return undefined\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch code block\n *\n * This function monitors size changes of the viewport, as well as switches of\n * content tabs with embedded code blocks, as both may trigger overflow.\n *\n * @param el - Code block element\n *\n * @returns Code block observable\n */\nexport function watchCodeBlock(\n el: HTMLElement\n): Observable {\n return watchElementSize(el)\n .pipe(\n map(({ width }) => {\n const content = getElementContentSize(el)\n return {\n scrollable: content.width > width\n }\n }),\n distinctUntilKeyChanged(\"scrollable\")\n )\n}\n\n/**\n * Mount code block\n *\n * This function ensures that an overflowing code block is focusable through\n * keyboard, so it can be scrolled without a mouse to improve on accessibility.\n * Furthermore, if code annotations are enabled, they are mounted if and only\n * if the code block is currently visible, e.g., not in a hidden content tab.\n *\n * Note that code blocks may be mounted eagerly or lazily. If they're mounted\n * lazily (on first visibility), code annotation anchor links will not work,\n * as they are evaluated on initial page load, and code annotations in general\n * might feel a little bumpier.\n *\n * @param el - Code block element\n * @param options - Options\n *\n * @returns Code block and annotation component observable\n */\nexport function mountCodeBlock(\n el: HTMLElement, options: MountOptions\n): Observable> {\n const { matches: hover } = matchMedia(\"(hover)\")\n\n /* Defer mounting of code block - see https://bit.ly/3vHVoVD */\n const factory$ = defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ scrollable }) => {\n if (scrollable && hover)\n el.setAttribute(\"tabindex\", \"0\")\n else\n el.removeAttribute(\"tabindex\")\n })\n\n /* Render button for Clipboard.js integration */\n if (ClipboardJS.isSupported()) {\n const parent = el.closest(\"pre\")!\n parent.id = `__code_${++sequence}`\n parent.insertBefore(\n renderClipboardButton(parent.id),\n el\n )\n }\n\n /* Handle code annotations */\n const container = el.closest(\".highlight\")\n if (container instanceof HTMLElement) {\n const list = findCandidateList(container)\n\n /* Mount code annotations, if enabled */\n if (typeof list !== \"undefined\" && (\n container.classList.contains(\"annotate\") ||\n feature(\"content.code.annotate\")\n )) {\n const annotations$ = mountAnnotationList(list, el, options)\n\n /* Create and return component */\n return watchCodeBlock(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state })),\n mergeWith(\n watchElementSize(container)\n .pipe(\n map(({ width, height }) => width && height),\n distinctUntilChanged(),\n switchMap(active => active ? annotations$ : EMPTY)\n )\n )\n )\n }\n }\n\n /* Create and return component */\n return watchCodeBlock(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n\n /* Mount code block lazily */\n if (feature(\"content.lazy\"))\n return watchElementVisibility(el)\n .pipe(\n filter(visible => visible),\n take(1),\n switchMap(() => factory$)\n )\n\n /* Mount code block */\n return factory$\n}\n", "/*\n * Copyright (c) 2016-2021 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a tooltip\n *\n * @param id - Tooltip identifier\n *\n * @returns Element\n */\nexport function renderTooltip(id?: string): HTMLElement {\n return (\n
\n
\n
\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\nimport { renderTooltip } from \"../tooltip\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render an annotation\n *\n * @param id - Annotation identifier\n * @param prefix - Tooltip identifier prefix\n *\n * @returns Element\n */\nexport function renderAnnotation(\n id: string | number, prefix?: string\n): HTMLElement {\n prefix = prefix ? `${prefix}_annotation_${id}` : undefined\n\n /* Render tooltip with anchor, if given */\n if (prefix) {\n const anchor = prefix ? `#${prefix}` : undefined\n return (\n \n )\n } else {\n return (\n \n )\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a 'copy-to-clipboard' button\n *\n * @param id - Unique identifier\n *\n * @returns Element\n */\nexport function renderClipboardButton(id: string): HTMLElement {\n return (\n code`}\n >\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ComponentChild } from \"preact\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport {\n SearchDocument,\n SearchMetadata,\n SearchResultItem\n} from \"~/integrations/search\"\nimport { h, truncate } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Render flag\n */\nconst enum Flag {\n TEASER = 1, /* Render teaser */\n PARENT = 2 /* Render as parent */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper function\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search document\n *\n * @param document - Search document\n * @param flag - Render flags\n *\n * @returns Element\n */\nfunction renderSearchDocument(\n document: SearchDocument & SearchMetadata, flag: Flag\n): HTMLElement {\n const parent = flag & Flag.PARENT\n const teaser = flag & Flag.TEASER\n\n /* Render missing query terms */\n const missing = Object.keys(document.terms)\n .filter(key => !document.terms[key])\n .reduce((list, key) => [\n ...list, {key}, \" \"\n ], [])\n .slice(0, -1)\n\n /* Assemble query string for highlighting */\n const url = new URL(document.location)\n if (feature(\"search.highlight\"))\n url.searchParams.set(\"h\", Object.entries(document.terms)\n .filter(([, match]) => match)\n .reduce((highlight, [value]) => `${highlight} ${value}`.trim(), \"\")\n )\n\n /* Render article or section, depending on flags */\n const { tags } = configuration()\n return (\n \n \n {parent > 0 &&
}\n

{document.title}

\n {teaser > 0 && document.text.length > 0 &&\n

\n {truncate(document.text, 320)}\n

\n }\n {document.tags && (\n
\n {document.tags.map(tag => {\n const id = tag.replace(/<[^>]+>/g, \"\")\n const type = tags\n ? id in tags\n ? `md-tag-icon md-tag-icon--${tags[id]}`\n : \"md-tag-icon\"\n : \"\"\n return (\n {tag}\n )\n })}\n
\n )}\n {teaser > 0 && missing.length > 0 &&\n

\n {translation(\"search.result.term.missing\")}: {...missing}\n

\n }\n \n \n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a search result\n *\n * @param result - Search result\n *\n * @returns Element\n */\nexport function renderSearchResultItem(\n result: SearchResultItem\n): HTMLElement {\n const threshold = result[0].score\n const docs = [...result]\n\n /* Find and extract parent article */\n const parent = docs.findIndex(doc => !doc.location.includes(\"#\"))\n const [article] = docs.splice(parent, 1)\n\n /* Determine last index above threshold */\n let index = docs.findIndex(doc => doc.score < threshold)\n if (index === -1)\n index = docs.length\n\n /* Partition sections */\n const best = docs.slice(0, index)\n const more = docs.slice(index)\n\n /* Render children */\n const children = [\n renderSearchDocument(article, Flag.PARENT | +(!parent && index === 0)),\n ...best.map(section => renderSearchDocument(section, Flag.TEASER)),\n ...more.length ? [\n
\n \n {more.length > 0 && more.length === 1\n ? translation(\"search.result.more.one\")\n : translation(\"search.result.more.other\", more.length)\n }\n \n {...more.map(section => renderSearchDocument(section, Flag.TEASER))}\n
\n ] : []\n ]\n\n /* Render search result */\n return (\n
  • \n {children}\n
    • \n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SourceFacts } from \"~/components\"\nimport { h, round } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render repository facts\n *\n * @param facts - Repository facts\n *\n * @returns Element\n */\nexport function renderSourceFacts(facts: SourceFacts): HTMLElement {\n return (\n
      \n {Object.entries(facts).map(([key, value]) => (\n
    • \n {typeof value === \"number\" ? round(value) : value}\n
      • \n ))}\n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Tabbed control type\n */\ntype TabbedControlType =\n | \"prev\"\n | \"next\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render control for content tabs\n *\n * @param type - Control type\n *\n * @returns Element\n */\nexport function renderTabbedControl(\n type: TabbedControlType\n): HTMLElement {\n const classes = `tabbed-control tabbed-control--${type}`\n return (\n \n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a table inside a wrapper to improve scrolling on mobile\n *\n * @param table - Table element\n *\n * @returns Element\n */\nexport function renderTable(table: HTMLElement): HTMLElement {\n return (\n
    \n
    \n {table}\n
    \n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { configuration, translation } from \"~/_\"\nimport { h } from \"~/utilities\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Version\n */\nexport interface Version {\n version: string /* Version identifier */\n title: string /* Version title */\n aliases: string[] /* Version aliases */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version\n *\n * @param version - Version\n *\n * @returns Element\n */\nfunction renderVersion(version: Version): HTMLElement {\n const config = configuration()\n\n /* Ensure trailing slash - see https://bit.ly/3rL5u3f */\n const url = new URL(`../${version.version}/`, config.base)\n return (\n
  • \n \n {version.title}\n \n
    • \n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Render a version selector\n *\n * @param versions - Versions\n * @param active - Active version\n *\n * @returns Element\n */\nexport function renderVersionSelector(\n versions: Version[], active: Version\n): HTMLElement {\n return (\n
    \n \n {active.title}\n \n
      \n {versions.map(renderVersion)}\n
    \n
    \n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n animationFrameScheduler,\n auditTime,\n combineLatest,\n debounceTime,\n defer,\n delay,\n filter,\n finalize,\n fromEvent,\n map,\n merge,\n switchMap,\n take,\n takeLast,\n takeUntil,\n tap,\n throttleTime,\n withLatestFrom\n} from \"rxjs\"\n\nimport {\n ElementOffset,\n getActiveElement,\n getElementSize,\n watchElementContentOffset,\n watchElementFocus,\n watchElementOffset,\n watchElementVisibility\n} from \"~/browser\"\n\nimport { Component } from \"../../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Annotation\n */\nexport interface Annotation {\n active: boolean /* Annotation is active */\n offset: ElementOffset /* Annotation offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n *\n * @returns Annotation observable\n */\nexport function watchAnnotation(\n el: HTMLElement, container: HTMLElement\n): Observable {\n const offset$ = defer(() => combineLatest([\n watchElementOffset(el),\n watchElementContentOffset(container)\n ]))\n .pipe(\n map(([{ x, y }, scroll]): ElementOffset => {\n const { width, height } = getElementSize(el)\n return ({\n x: x - scroll.x + width / 2,\n y: y - scroll.y + height / 2\n })\n })\n )\n\n /* Actively watch annotation on focus */\n return watchElementFocus(el)\n .pipe(\n switchMap(active => offset$\n .pipe(\n map(offset => ({ active, offset })),\n take(+!active || Infinity)\n )\n )\n )\n}\n\n/**\n * Mount annotation\n *\n * @param el - Annotation element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotation(\n el: HTMLElement, container: HTMLElement, { target$ }: MountOptions\n): Observable> {\n const [tooltip, index] = Array.from(el.children)\n\n /* Mount component on subscription */\n return defer(() => {\n const push$ = new Subject()\n const done$ = push$.pipe(takeLast(1))\n push$.subscribe({\n\n /* Handle emission */\n next({ offset }) {\n el.style.setProperty(\"--md-tooltip-x\", `${offset.x}px`)\n el.style.setProperty(\"--md-tooltip-y\", `${offset.y}px`)\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-tooltip-x\")\n el.style.removeProperty(\"--md-tooltip-y\")\n }\n })\n\n /* Start animation only when annotation is visible */\n watchElementVisibility(el)\n .pipe(\n takeUntil(done$)\n )\n .subscribe(visible => {\n el.toggleAttribute(\"data-md-visible\", visible)\n })\n\n /* Toggle tooltip presence to mitigate empty lines when copying */\n merge(\n push$.pipe(filter(({ active }) => active)),\n push$.pipe(debounceTime(250), filter(({ active }) => !active))\n )\n .subscribe({\n\n /* Handle emission */\n next({ active }) {\n if (active)\n el.prepend(tooltip)\n else\n tooltip.remove()\n },\n\n /* Handle complete */\n complete() {\n el.prepend(tooltip)\n }\n })\n\n /* Toggle tooltip visibility */\n push$\n .pipe(\n auditTime(16, animationFrameScheduler)\n )\n .subscribe(({ active }) => {\n tooltip.classList.toggle(\"md-tooltip--active\", active)\n })\n\n /* Track relative origin of tooltip */\n push$\n .pipe(\n throttleTime(125, animationFrameScheduler),\n filter(() => !!el.offsetParent),\n map(() => el.offsetParent!.getBoundingClientRect()),\n map(({ x }) => x)\n )\n .subscribe({\n\n /* Handle emission */\n next(origin) {\n if (origin)\n el.style.setProperty(\"--md-tooltip-0\", `${-origin}px`)\n else\n el.style.removeProperty(\"--md-tooltip-0\")\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-tooltip-0\")\n }\n })\n\n /* Allow to copy link without scrolling to anchor */\n fromEvent(index, \"click\")\n .pipe(\n takeUntil(done$),\n filter(ev => !(ev.metaKey || ev.ctrlKey))\n )\n .subscribe(ev => ev.preventDefault())\n\n /* Allow to open link in new tab or blur on close */\n fromEvent(index, \"mousedown\")\n .pipe(\n takeUntil(done$),\n withLatestFrom(push$)\n )\n .subscribe(([ev, { active }]) => {\n\n /* Open in new tab */\n if (ev.button !== 0 || ev.metaKey || ev.ctrlKey) {\n ev.preventDefault()\n\n /* Close annotation */\n } else if (active) {\n ev.preventDefault()\n\n /* Focus parent annotation, if any */\n const parent = el.parentElement!.closest(\".md-annotation\")\n if (parent instanceof HTMLElement)\n parent.focus()\n else\n getActiveElement()?.blur()\n }\n })\n\n /* Open and focus annotation on location target */\n target$\n .pipe(\n takeUntil(done$),\n filter(target => target === tooltip),\n delay(125)\n )\n .subscribe(() => el.focus())\n\n /* Create and return component */\n return watchAnnotation(el, container)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n finalize,\n merge,\n share,\n takeLast,\n takeUntil\n} from \"rxjs\"\n\nimport {\n getElement,\n getElements,\n getOptionalElement\n} from \"~/browser\"\nimport { renderAnnotation } from \"~/templates\"\n\nimport { Component } from \"../../../_\"\nimport {\n Annotation,\n mountAnnotation\n} from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Find all annotation markers in the given code block\n *\n * @param container - Containing element\n *\n * @returns Annotation markers\n */\nfunction findAnnotationMarkers(container: HTMLElement): Text[] {\n const markers: Text[] = []\n for (const el of getElements(\".c, .c1, .cm\", container)) {\n const nodes: Text[] = []\n\n /* Find all text nodes in current element */\n const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n for (let node = it.nextNode(); node; node = it.nextNode())\n nodes.push(node as Text)\n\n /* Find all markers in each text node */\n for (let text of nodes) {\n let match: RegExpExecArray | null\n\n /* Split text at marker and add to list */\n while ((match = /(\\(\\d+\\))(!)?/.exec(text.textContent!))) {\n const [, id, force] = match\n if (typeof force === \"undefined\") {\n const marker = text.splitText(match.index)\n text = marker.splitText(id.length)\n markers.push(marker)\n\n /* Replace entire text with marker */\n } else {\n text.textContent = id\n markers.push(text)\n break\n }\n }\n }\n }\n return markers\n}\n\n/**\n * Swap the child nodes of two elements\n *\n * @param source - Source element\n * @param target - Target element\n */\nfunction swap(source: HTMLElement, target: HTMLElement): void {\n target.append(...Array.from(source.childNodes))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount annotation list\n *\n * This function analyzes the containing code block and checks for markers\n * referring to elements in the given annotation list. If no markers are found,\n * the list is left untouched. Otherwise, list elements are rendered as\n * annotations inside the code block.\n *\n * @param el - Annotation list element\n * @param container - Containing element\n * @param options - Options\n *\n * @returns Annotation component observable\n */\nexport function mountAnnotationList(\n el: HTMLElement, container: HTMLElement, { target$, print$ }: MountOptions\n): Observable> {\n\n /* Compute prefix for tooltip anchors */\n const parent = container.closest(\"[id]\")\n const prefix = parent?.id\n\n /* Find and replace all markers with empty annotations */\n const annotations = new Map()\n for (const marker of findAnnotationMarkers(container)) {\n const [, id] = marker.textContent!.match(/\\((\\d+)\\)/)!\n if (getOptionalElement(`li:nth-child(${id})`, el)) {\n annotations.set(id, renderAnnotation(id, prefix))\n marker.replaceWith(annotations.get(id)!)\n }\n }\n\n /* Keep list if there are no annotations to render */\n if (annotations.size === 0)\n return EMPTY\n\n /* Mount component on subscription */\n return defer(() => {\n const done$ = new Subject()\n\n /* Retrieve container pairs for swapping */\n const pairs: [HTMLElement, HTMLElement][] = []\n for (const [id, annotation] of annotations)\n pairs.push([\n getElement(\".md-typeset\", annotation),\n getElement(`li:nth-child(${id})`, el)\n ])\n\n /* Handle print mode - see https://bit.ly/3rgPdpt */\n print$\n .pipe(\n takeUntil(done$.pipe(takeLast(1)))\n )\n .subscribe(active => {\n el.hidden = !active\n\n /* Show annotations in code block or list (print) */\n for (const [inner, child] of pairs)\n if (!active)\n swap(child, inner)\n else\n swap(inner, child)\n })\n\n /* Create and return component */\n return merge(...[...annotations]\n .map(([, annotation]) => (\n mountAnnotation(annotation, container, { target$ })\n ))\n )\n .pipe(\n finalize(() => done$.complete()),\n share()\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n map,\n of,\n shareReplay,\n tap\n} from \"rxjs\"\n\nimport { watchScript } from \"~/browser\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../../_\"\n\nimport themeCSS from \"./index.css\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid diagram\n */\nexport interface Mermaid {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Mermaid instance observable\n */\nlet mermaid$: Observable\n\n/**\n * Global sequence number for diagrams\n */\nlet sequence = 0\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch Mermaid script\n *\n * @returns Mermaid scripts observable\n */\nfunction fetchScripts(): Observable {\n return typeof mermaid === \"undefined\" || mermaid instanceof Element\n ? watchScript(\"https://unpkg.com/mermaid@9.1.7/dist/mermaid.min.js\")\n : of(undefined)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount Mermaid diagram\n *\n * @param el - Code block element\n *\n * @returns Mermaid diagram component observable\n */\nexport function mountMermaid(\n el: HTMLElement\n): Observable> {\n el.classList.remove(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n mermaid$ ||= fetchScripts()\n .pipe(\n tap(() => mermaid.initialize({\n startOnLoad: false,\n themeCSS,\n sequence: {\n actorFontSize: \"16px\", // Hack: mitigate https://bit.ly/3y0NEi3\n messageFontSize: \"16px\",\n noteFontSize: \"16px\"\n }\n })),\n map(() => undefined),\n shareReplay(1)\n )\n\n /* Render diagram */\n mermaid$.subscribe(() => {\n el.classList.add(\"mermaid\") // Hack: mitigate https://bit.ly/3CiN6Du\n const id = `__mermaid_${sequence++}`\n const host = h(\"div\", { class: \"mermaid\" })\n mermaid.mermaidAPI.render(id, el.textContent, (svg: string) => {\n\n /* Create a shadow root and inject diagram */\n const shadow = host.attachShadow({ mode: \"closed\" })\n shadow.innerHTML = svg\n\n /* Replace code block with diagram */\n el.replaceWith(host)\n })\n })\n\n /* Create and return component */\n return mermaid$\n .pipe(\n map(() => ({ ref: el }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n filter,\n finalize,\n map,\n merge,\n tap\n} from \"rxjs\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Details\n */\nexport interface Details {\n action: \"open\" | \"close\" /* Details state */\n reveal?: boolean /* Details is revealed */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch details\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details observable\n */\nexport function watchDetails(\n el: HTMLDetailsElement, { target$, print$ }: WatchOptions\n): Observable
    {\n let open = true\n return merge(\n\n /* Open and focus details on location target */\n target$\n .pipe(\n map(target => target.closest(\"details:not([open])\")!),\n filter(details => el === details),\n map(() => ({\n action: \"open\", reveal: true\n }) as Details)\n ),\n\n /* Open details on print and close afterwards */\n print$\n .pipe(\n filter(active => active || !open),\n tap(() => open = el.open),\n map(active => ({\n action: active ? \"open\" : \"close\"\n }) as Details)\n )\n )\n}\n\n/**\n * Mount details\n *\n * This function ensures that `details` tags are opened on anchor jumps and\n * prior to printing, so the whole content of the page is visible.\n *\n * @param el - Details element\n * @param options - Options\n *\n * @returns Details component observable\n */\nexport function mountDetails(\n el: HTMLDetailsElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject
    ()\n push$.subscribe(({ action, reveal }) => {\n el.toggleAttribute(\"open\", action === \"open\")\n if (reveal)\n el.scrollIntoView()\n })\n\n /* Create and return component */\n return watchDetails(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, of } from \"rxjs\"\n\nimport { renderTable } from \"~/templates\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Data table\n */\nexport interface DataTable {}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Sentinel for replacement\n */\nconst sentinel = h(\"table\")\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount data table\n *\n * This function wraps a data table in another scrollable container, so it can\n * be smoothly scrolled on smaller screen sizes and won't break the layout.\n *\n * @param el - Data table element\n *\n * @returns Data table component observable\n */\nexport function mountDataTable(\n el: HTMLElement\n): Observable> {\n el.replaceWith(sentinel)\n sentinel.replaceWith(renderTable(el))\n\n /* Create and return component */\n return of({ ref: el })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n animationFrameScheduler,\n asyncScheduler,\n auditTime,\n combineLatest,\n defer,\n finalize,\n fromEvent,\n map,\n merge,\n skip,\n startWith,\n subscribeOn,\n takeLast,\n takeUntil,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n getElement,\n getElementContentOffset,\n getElementContentSize,\n getElementOffset,\n getElementSize,\n getElements,\n watchElementContentOffset,\n watchElementSize\n} from \"~/browser\"\nimport { renderTabbedControl } from \"~/templates\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content tabs\n */\nexport interface ContentTabs {\n active: HTMLLabelElement /* Active tab label */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch content tabs\n *\n * @param el - Content tabs element\n *\n * @returns Content tabs observable\n */\nexport function watchContentTabs(\n el: HTMLElement\n): Observable {\n const inputs = getElements(\":scope > input\", el)\n const initial = inputs.find(input => input.checked) || inputs[0]\n return merge(...inputs.map(input => fromEvent(input, \"change\")\n .pipe(\n map(() => getElement(`label[for=\"${input.id}\"]`))\n )\n ))\n .pipe(\n startWith(getElement(`label[for=\"${initial.id}\"]`)),\n map(active => ({ active }))\n )\n}\n\n/**\n * Mount content tabs\n *\n * This function scrolls the active tab into view. While this functionality is\n * provided by browsers as part of `scrollInfoView`, browsers will always also\n * scroll the vertical axis, which we do not want. Thus, we decided to provide\n * this functionality ourselves.\n *\n * @param el - Content tabs element\n * @param options - Options\n *\n * @returns Content tabs component observable\n */\nexport function mountContentTabs(\n el: HTMLElement, { viewport$ }: MountOptions\n): Observable> {\n\n /* Render content tab previous button for pagination */\n const prev = renderTabbedControl(\"prev\")\n el.append(prev)\n\n /* Render content tab next button for pagination */\n const next = renderTabbedControl(\"next\")\n el.append(next)\n\n /* Mount component on subscription */\n const container = getElement(\".tabbed-labels\", el)\n return defer(() => {\n const push$ = new Subject()\n const done$ = push$.pipe(takeLast(1))\n combineLatest([push$, watchElementSize(el)])\n .pipe(\n auditTime(1, animationFrameScheduler),\n takeUntil(done$)\n )\n .subscribe({\n\n /* Handle emission */\n next([{ active }, size]) {\n const offset = getElementOffset(active)\n const { width } = getElementSize(active)\n\n /* Set tab indicator offset and width */\n el.style.setProperty(\"--md-indicator-x\", `${offset.x}px`)\n el.style.setProperty(\"--md-indicator-width\", `${width}px`)\n\n /* Scroll container to active content tab */\n const content = getElementContentOffset(container)\n if (\n offset.x < content.x ||\n offset.x + width > content.x + size.width\n )\n container.scrollTo({\n left: Math.max(0, offset.x - 16),\n behavior: \"smooth\"\n })\n },\n\n /* Handle complete */\n complete() {\n el.style.removeProperty(\"--md-indicator-x\")\n el.style.removeProperty(\"--md-indicator-width\")\n }\n })\n\n /* Hide content tab buttons on borders */\n combineLatest([\n watchElementContentOffset(container),\n watchElementSize(container)\n ])\n .pipe(\n takeUntil(done$)\n )\n .subscribe(([offset, size]) => {\n const content = getElementContentSize(container)\n prev.hidden = offset.x < 16\n next.hidden = offset.x > content.width - size.width - 16\n })\n\n /* Paginate content tab container on click */\n merge(\n fromEvent(prev, \"click\").pipe(map(() => -1)),\n fromEvent(next, \"click\").pipe(map(() => +1))\n )\n .pipe(\n takeUntil(done$)\n )\n .subscribe(direction => {\n const { width } = getElementSize(container)\n container.scrollBy({\n left: width * direction,\n behavior: \"smooth\"\n })\n })\n\n /* Set up linking of content tabs, if enabled */\n if (feature(\"content.tabs.link\"))\n push$.pipe(\n skip(1),\n withLatestFrom(viewport$)\n )\n .subscribe(([{ active }, { offset }]) => {\n const tab = active.innerText.trim()\n if (active.hasAttribute(\"data-md-switching\")) {\n active.removeAttribute(\"data-md-switching\")\n\n /* Determine viewport offset of active tab */\n } else {\n const y = el.offsetTop - offset.y\n\n /* Passively activate other tabs */\n for (const set of getElements(\"[data-tabs]\"))\n for (const input of getElements(\n \":scope > input\", set\n )) {\n const label = getElement(`label[for=\"${input.id}\"]`)\n if (\n label !== active &&\n label.innerText.trim() === tab\n ) {\n label.setAttribute(\"data-md-switching\", \"\")\n input.click()\n break\n }\n }\n\n /* Bring active tab into view */\n window.scrollTo({\n top: el.offsetTop - y\n })\n\n /* Persist active tabs in local storage */\n const tabs = __md_get(\"__tabs\") || []\n __md_set(\"__tabs\", [...new Set([tab, ...tabs])])\n }\n })\n\n /* Create and return component */\n return watchContentTabs(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n .pipe(\n subscribeOn(asyncScheduler)\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Observable, merge } from \"rxjs\"\n\nimport { Viewport, getElements } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Annotation } from \"../annotation\"\nimport {\n CodeBlock,\n Mermaid,\n mountCodeBlock,\n mountMermaid\n} from \"../code\"\nimport {\n Details,\n mountDetails\n} from \"../details\"\nimport {\n DataTable,\n mountDataTable\n} from \"../table\"\nimport {\n ContentTabs,\n mountContentTabs\n} from \"../tabs\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Content\n */\nexport type Content =\n | Annotation\n | ContentTabs\n | CodeBlock\n | Mermaid\n | DataTable\n | Details\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n target$: Observable /* Location target observable */\n print$: Observable /* Media print observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount content\n *\n * This function mounts all components that are found in the content of the\n * actual article, including code blocks, data tables and details.\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Content component observable\n */\nexport function mountContent(\n el: HTMLElement, { viewport$, target$, print$ }: MountOptions\n): Observable> {\n return merge(\n\n /* Code blocks */\n ...getElements(\"pre:not(.mermaid) > code\", el)\n .map(child => mountCodeBlock(child, { target$, print$ })),\n\n /* Mermaid diagrams */\n ...getElements(\"pre.mermaid\", el)\n .map(child => mountMermaid(child)),\n\n /* Data tables */\n ...getElements(\"table:not([class])\", el)\n .map(child => mountDataTable(child)),\n\n /* Details */\n ...getElements(\"details\", el)\n .map(child => mountDetails(child, { target$, print$ })),\n\n /* Content tabs */\n ...getElements(\"[data-tabs]\", el)\n .map(child => mountContentTabs(child, { viewport$ }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n delay,\n finalize,\n map,\n merge,\n of,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Dialog\n */\nexport interface Dialog {\n message: string /* Dialog message */\n active: boolean /* Dialog is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n alert$: Subject /* Alert subject */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n alert$: Subject /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch dialog\n *\n * @param _el - Dialog element\n * @param options - Options\n *\n * @returns Dialog observable\n */\nexport function watchDialog(\n _el: HTMLElement, { alert$ }: WatchOptions\n): Observable {\n return alert$\n .pipe(\n switchMap(message => merge(\n of(true),\n of(false).pipe(delay(2000))\n )\n .pipe(\n map(active => ({ message, active }))\n )\n )\n )\n}\n\n/**\n * Mount dialog\n *\n * This function reveals the dialog in the right corner when a new alert is\n * emitted through the subject that is passed as part of the options.\n *\n * @param el - Dialog element\n * @param options - Options\n *\n * @returns Dialog component observable\n */\nexport function mountDialog(\n el: HTMLElement, options: MountOptions\n): Observable> {\n const inner = getElement(\".md-typeset\", el)\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ message, active }) => {\n el.classList.toggle(\"md-dialog--active\", active)\n inner.textContent = message\n })\n\n /* Create and return component */\n return watchDialog(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatest,\n combineLatestWith,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n map,\n of,\n shareReplay,\n startWith,\n switchMap,\n takeLast,\n takeUntil\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n watchElementSize,\n watchToggle\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Main } from \"../../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface Header {\n height: number /* Header visible height */\n hidden: boolean /* Header is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute whether the header is hidden\n *\n * If the user scrolls past a certain threshold, the header can be hidden when\n * scrolling down, and shown when scrolling up.\n *\n * @param options - Options\n *\n * @returns Toggle observable\n */\nfunction isHidden({ viewport$ }: WatchOptions): Observable {\n if (!feature(\"header.autohide\"))\n return of(false)\n\n /* Compute direction and turning point */\n const direction$ = viewport$\n .pipe(\n map(({ offset: { y } }) => y),\n bufferCount(2, 1),\n map(([a, b]) => [a < b, b] as const),\n distinctUntilKeyChanged(0)\n )\n\n /* Compute whether header should be hidden */\n const hidden$ = combineLatest([viewport$, direction$])\n .pipe(\n filter(([{ offset }, [, y]]) => Math.abs(y - offset.y) > 100),\n map(([, [direction]]) => direction),\n distinctUntilChanged()\n )\n\n /* Compute threshold for hiding */\n const search$ = watchToggle(\"search\")\n return combineLatest([viewport$, search$])\n .pipe(\n map(([{ offset }, search]) => offset.y > 400 && !search),\n distinctUntilChanged(),\n switchMap(active => active ? hidden$ : of(false)),\n startWith(false)\n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header observable\n */\nexport function watchHeader(\n el: HTMLElement, options: WatchOptions\n): Observable
    {\n return defer(() => combineLatest([\n watchElementSize(el),\n isHidden(options)\n ]))\n .pipe(\n map(([{ height }, hidden]) => ({\n height,\n hidden\n })),\n distinctUntilChanged((a, b) => (\n a.height === b.height &&\n a.hidden === b.hidden\n )),\n shareReplay(1)\n )\n}\n\n/**\n * Mount header\n *\n * This function manages the different states of the header, i.e. whether it's\n * hidden or rendered with a shadow. This depends heavily on the main area.\n *\n * @param el - Header element\n * @param options - Options\n *\n * @returns Header component observable\n */\nexport function mountHeader(\n el: HTMLElement, { header$, main$ }: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject
    ()\n const done$ = push$.pipe(takeLast(1))\n push$\n .pipe(\n distinctUntilKeyChanged(\"active\"),\n combineLatestWith(header$)\n )\n .subscribe(([{ active }, { hidden }]) => {\n el.classList.toggle(\"md-header--shadow\", active && !hidden)\n el.hidden = hidden\n })\n\n /* Link to main area */\n main$.subscribe(push$)\n\n /* Create and return component */\n return header$\n .pipe(\n takeUntil(done$),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n defer,\n distinctUntilKeyChanged,\n finalize,\n map,\n tap\n} from \"rxjs\"\n\nimport {\n Viewport,\n getElementSize,\n getOptionalElement,\n watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { Header } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Header\n */\nexport interface HeaderTitle {\n active: boolean /* Header title is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch header title\n *\n * @param el - Heading element\n * @param options - Options\n *\n * @returns Header title observable\n */\nexport function watchHeaderTitle(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n return watchViewportAt(el, { viewport$, header$ })\n .pipe(\n map(({ offset: { y } }) => {\n const { height } = getElementSize(el)\n return {\n active: y >= height\n }\n }),\n distinctUntilKeyChanged(\"active\")\n )\n}\n\n/**\n * Mount header title\n *\n * This function swaps the header title from the site title to the title of the\n * current page when the user scrolls past the first headline.\n *\n * @param el - Header title element\n * @param options - Options\n *\n * @returns Header title component observable\n */\nexport function mountHeaderTitle(\n el: HTMLElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ active }) => {\n el.classList.toggle(\"md-header__title--active\", active)\n })\n\n /* Obtain headline, if any */\n const heading = getOptionalElement(\"article h1\")\n if (typeof heading === \"undefined\")\n return EMPTY\n\n /* Create and return component */\n return watchHeaderTitle(heading, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n map,\n switchMap\n} from \"rxjs\"\n\nimport {\n Viewport,\n watchElementSize\n} from \"~/browser\"\n\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Main area\n */\nexport interface Main {\n offset: number /* Main area top offset */\n height: number /* Main area visible height */\n active: boolean /* Main area is active */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch main area\n *\n * This function returns an observable that computes the visual parameters of\n * the main area which depends on the viewport vertical offset and height, as\n * well as the height of the header element, if the header is fixed.\n *\n * @param el - Main area element\n * @param options - Options\n *\n * @returns Main area observable\n */\nexport function watchMain(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable
    {\n\n /* Compute necessary adjustment for header */\n const adjust$ = header$\n .pipe(\n map(({ height }) => height),\n distinctUntilChanged()\n )\n\n /* Compute the main area's top and bottom borders */\n const border$ = adjust$\n .pipe(\n switchMap(() => watchElementSize(el)\n .pipe(\n map(({ height }) => ({\n top: el.offsetTop,\n bottom: el.offsetTop + height\n })),\n distinctUntilKeyChanged(\"bottom\")\n )\n )\n )\n\n /* Compute the main area's offset, visible height and if we scrolled past */\n return combineLatest([adjust$, border$, viewport$])\n .pipe(\n map(([header, { top, bottom }, { offset: { y }, size: { height } }]) => {\n height = Math.max(0, height\n - Math.max(0, top - y, header)\n - Math.max(0, height + y - bottom)\n )\n return {\n offset: top - header,\n height,\n active: top - header <= y\n }\n }),\n distinctUntilChanged((a, b) => (\n a.offset === b.offset &&\n a.height === b.height &&\n a.active === b.active\n ))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n asyncScheduler,\n defer,\n finalize,\n fromEvent,\n map,\n mergeMap,\n observeOn,\n of,\n shareReplay,\n startWith,\n tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\nimport { Component } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Palette colors\n */\nexport interface PaletteColor {\n scheme?: string /* Color scheme */\n primary?: string /* Primary color */\n accent?: string /* Accent color */\n}\n\n/**\n * Palette\n */\nexport interface Palette {\n index: number /* Palette index */\n color: PaletteColor /* Palette colors */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch color palette\n *\n * @param inputs - Color palette element\n *\n * @returns Color palette observable\n */\nexport function watchPalette(\n inputs: HTMLInputElement[]\n): Observable {\n const current = __md_get(\"__palette\") || {\n index: inputs.findIndex(input => matchMedia(\n input.getAttribute(\"data-md-color-media\")!\n ).matches)\n }\n\n /* Emit changes in color palette */\n return of(...inputs)\n .pipe(\n mergeMap(input => fromEvent(input, \"change\")\n .pipe(\n map(() => input)\n )\n ),\n startWith(inputs[Math.max(0, current.index)]),\n map(input => ({\n index: inputs.indexOf(input),\n color: {\n scheme: input.getAttribute(\"data-md-color-scheme\"),\n primary: input.getAttribute(\"data-md-color-primary\"),\n accent: input.getAttribute(\"data-md-color-accent\")\n }\n } as Palette)),\n shareReplay(1)\n )\n}\n\n/**\n * Mount color palette\n *\n * @param el - Color palette element\n *\n * @returns Color palette component observable\n */\nexport function mountPalette(\n el: HTMLElement\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(palette => {\n document.body.setAttribute(\"data-md-color-switching\", \"\")\n\n /* Set color palette */\n for (const [key, value] of Object.entries(palette.color))\n document.body.setAttribute(`data-md-color-${key}`, value)\n\n /* Toggle visibility */\n for (let index = 0; index < inputs.length; index++) {\n const label = inputs[index].nextElementSibling\n if (label instanceof HTMLElement)\n label.hidden = palette.index !== index\n }\n\n /* Persist preference in local storage */\n __md_set(\"__palette\", palette)\n })\n\n /* Revert transition durations after color switch */\n push$.pipe(observeOn(asyncScheduler))\n .subscribe(() => {\n document.body.removeAttribute(\"data-md-color-switching\")\n })\n\n /* Create and return component */\n const inputs = getElements(\"input\", el)\n return watchPalette(inputs)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport ClipboardJS from \"clipboard\"\nimport {\n Observable,\n Subject,\n map,\n tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport { getElement } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n alert$: Subject /* Alert subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Extract text to copy\n *\n * @param el - HTML element\n *\n * @returns Extracted text\n */\nfunction extract(el: HTMLElement): string {\n el.setAttribute(\"data-md-copying\", \"\")\n const text = el.innerText\n el.removeAttribute(\"data-md-copying\")\n return text\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up Clipboard.js integration\n *\n * @param options - Options\n */\nexport function setupClipboardJS(\n { alert$ }: SetupOptions\n): void {\n if (ClipboardJS.isSupported()) {\n new Observable(subscriber => {\n new ClipboardJS(\"[data-clipboard-target], [data-clipboard-text]\", {\n text: el => (\n el.getAttribute(\"data-clipboard-text\")! ||\n extract(getElement(\n el.getAttribute(\"data-clipboard-target\")!\n ))\n )\n })\n .on(\"success\", ev => subscriber.next(ev))\n })\n .pipe(\n tap(ev => {\n const trigger = ev.trigger as HTMLElement\n trigger.focus()\n }),\n map(() => translation(\"clipboard.copied\"))\n )\n .subscribe(alert$)\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n catchError,\n defaultIfEmpty,\n map,\n of,\n tap\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport { getElements, requestXML } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sitemap, i.e. a list of URLs\n */\nexport type Sitemap = string[]\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Preprocess a list of URLs\n *\n * This function replaces the `site_url` in the sitemap with the actual base\n * URL, to allow instant loading to work in occasions like Netlify previews.\n *\n * @param urls - URLs\n *\n * @returns URL path parts\n */\nfunction preprocess(urls: Sitemap): Sitemap {\n if (urls.length < 2)\n return [\"\"]\n\n /* Take the first two URLs and remove everything after the last slash */\n const [root, next] = [...urls]\n .sort((a, b) => a.length - b.length)\n .map(url => url.replace(/[^/]+$/, \"\"))\n\n /* Compute common prefix */\n let index = 0\n if (root === next)\n index = root.length\n else\n while (root.charCodeAt(index) === next.charCodeAt(index))\n index++\n\n /* Remove common prefix and return in original order */\n return urls.map(url => url.replace(root.slice(0, index), \"\"))\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch the sitemap for the given base URL\n *\n * @param base - Base URL\n *\n * @returns Sitemap observable\n */\nexport function fetchSitemap(base?: URL): Observable {\n const cached = __md_get(\"__sitemap\", sessionStorage, base)\n if (cached) {\n return of(cached)\n } else {\n const config = configuration()\n return requestXML(new URL(\"sitemap.xml\", base || config.base))\n .pipe(\n map(sitemap => preprocess(getElements(\"loc\", sitemap)\n .map(node => node.textContent!)\n )),\n catchError(() => EMPTY), // @todo refactor instant loading\n defaultIfEmpty([]),\n tap(sitemap => __md_set(\"__sitemap\", sitemap, sessionStorage, base))\n )\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n NEVER,\n Observable,\n Subject,\n bufferCount,\n catchError,\n concatMap,\n debounceTime,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n fromEvent,\n map,\n merge,\n of,\n sample,\n share,\n skip,\n skipUntil,\n switchMap\n} from \"rxjs\"\n\nimport { configuration, feature } from \"~/_\"\nimport {\n Viewport,\n ViewportOffset,\n getElements,\n getOptionalElement,\n request,\n setLocation,\n setLocationHash\n} from \"~/browser\"\nimport { getComponentElement } from \"~/components\"\nimport { h } from \"~/utilities\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * History state\n */\nexport interface HistoryState {\n url: URL /* State URL */\n offset?: ViewportOffset /* State viewport offset */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n document$: Subject /* Document subject */\n location$: Subject /* Location subject */\n viewport$: Observable /* Viewport observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up instant loading\n *\n * When fetching, theoretically, we could use `responseType: \"document\"`, but\n * since all MkDocs links are relative, we need to make sure that the current\n * location matches the document we just loaded. Otherwise any relative links\n * in the document could use the old location.\n *\n * This is the reason why we need to synchronize history events and the process\n * of fetching the document for navigation changes (except `popstate` events):\n *\n * 1. Fetch document via `XMLHTTPRequest`\n * 2. Set new location via `history.pushState`\n * 3. Parse and emit fetched document\n *\n * For `popstate` events, we must not use `history.pushState`, or the forward\n * history will be irreversibly overwritten. In case the request fails, the\n * location change is dispatched regularly.\n *\n * @param options - Options\n */\nexport function setupInstantLoading(\n { document$, location$, viewport$ }: SetupOptions\n): void {\n const config = configuration()\n if (location.protocol === \"file:\")\n return\n\n /* Disable automatic scroll restoration */\n if (\"scrollRestoration\" in history) {\n history.scrollRestoration = \"manual\"\n\n /* Hack: ensure that reloads restore viewport offset */\n fromEvent(window, \"beforeunload\")\n .subscribe(() => {\n history.scrollRestoration = \"auto\"\n })\n }\n\n /* Hack: ensure absolute favicon link to omit 404s when switching */\n const favicon = getOptionalElement(\"link[rel=icon]\")\n if (typeof favicon !== \"undefined\")\n favicon.href = favicon.href\n\n /* Intercept internal navigation */\n const push$ = fetchSitemap()\n .pipe(\n map(paths => paths.map(path => `${new URL(path, config.base)}`)),\n switchMap(urls => fromEvent(document.body, \"click\")\n .pipe(\n filter(ev => !ev.metaKey && !ev.ctrlKey),\n switchMap(ev => {\n if (ev.target instanceof Element) {\n const el = ev.target.closest(\"a\")\n if (el && !el.target) {\n const url = new URL(el.href)\n\n /* Canonicalize URL */\n url.search = \"\"\n url.hash = \"\"\n\n /* Check if URL should be intercepted */\n if (\n url.pathname !== location.pathname &&\n urls.includes(url.toString())\n ) {\n ev.preventDefault()\n return of({\n url: new URL(el.href)\n })\n }\n }\n }\n return NEVER\n })\n )\n ),\n share()\n )\n\n /* Intercept history back and forward */\n const pop$ = fromEvent(window, \"popstate\")\n .pipe(\n filter(ev => ev.state !== null),\n map(ev => ({\n url: new URL(location.href),\n offset: ev.state\n })),\n share()\n )\n\n /* Emit location change */\n merge(push$, pop$)\n .pipe(\n distinctUntilChanged((a, b) => a.url.href === b.url.href),\n map(({ url }) => url)\n )\n .subscribe(location$)\n\n /* Fetch document via `XMLHTTPRequest` */\n const response$ = location$\n .pipe(\n distinctUntilKeyChanged(\"pathname\"),\n switchMap(url => request(url.href)\n .pipe(\n catchError(() => {\n setLocation(url)\n return NEVER\n })\n )\n ),\n share()\n )\n\n /* Set new location via `history.pushState` */\n push$\n .pipe(\n sample(response$)\n )\n .subscribe(({ url }) => {\n history.pushState({}, \"\", `${url}`)\n })\n\n /* Parse and emit fetched document */\n const dom = new DOMParser()\n response$\n .pipe(\n switchMap(res => res.text()),\n map(res => dom.parseFromString(res, \"text/html\"))\n )\n .subscribe(document$)\n\n /* Replace meta tags and components */\n document$\n .pipe(\n skip(1)\n )\n .subscribe(replacement => {\n for (const selector of [\n\n /* Meta tags */\n \"title\",\n \"link[rel=canonical]\",\n \"meta[name=author]\",\n \"meta[name=description]\",\n\n /* Components */\n \"[data-md-component=announce]\",\n \"[data-md-component=container]\",\n \"[data-md-component=header-topic]\",\n \"[data-md-component=outdated]\",\n \"[data-md-component=logo]\",\n \"[data-md-component=skip]\",\n ...feature(\"navigation.tabs.sticky\")\n ? [\"[data-md-component=tabs]\"]\n : []\n ]) {\n const source = getOptionalElement(selector)\n const target = getOptionalElement(selector, replacement)\n if (\n typeof source !== \"undefined\" &&\n typeof target !== \"undefined\"\n ) {\n source.replaceWith(target)\n }\n }\n })\n\n /* Re-evaluate scripts */\n document$\n .pipe(\n skip(1),\n map(() => getComponentElement(\"container\")),\n switchMap(el => getElements(\"script\", el)),\n concatMap(el => {\n const script = h(\"script\")\n if (el.src) {\n for (const name of el.getAttributeNames())\n script.setAttribute(name, el.getAttribute(name)!)\n el.replaceWith(script)\n\n /* Complete when script is loaded */\n return new Observable(observer => {\n script.onload = () => observer.complete()\n })\n\n /* Complete immediately */\n } else {\n script.textContent = el.textContent\n el.replaceWith(script)\n return EMPTY\n }\n })\n )\n .subscribe()\n\n /* Emit history state change */\n merge(push$, pop$)\n .pipe(\n sample(document$)\n )\n .subscribe(({ url, offset }) => {\n if (url.hash && !offset) {\n setLocationHash(url.hash)\n } else {\n window.scrollTo(0, offset?.y || 0)\n }\n })\n\n /* Debounce update of viewport offset */\n viewport$\n .pipe(\n skipUntil(push$),\n debounceTime(250),\n distinctUntilKeyChanged(\"offset\")\n )\n .subscribe(({ offset }) => {\n history.replaceState(offset, \"\")\n })\n\n /* Set viewport offset from history */\n merge(push$, pop$)\n .pipe(\n bufferCount(2, 1),\n filter(([a, b]) => a.url.pathname === b.url.pathname),\n map(([, state]) => state)\n )\n .subscribe(({ offset }) => {\n window.scrollTo(0, offset?.y || 0)\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexDocument } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search document\n */\nexport interface SearchDocument extends SearchIndexDocument {\n parent?: SearchIndexDocument /* Parent article */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search document mapping\n */\nexport type SearchDocumentMap = Map\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document mapping\n *\n * @param docs - Search index documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n docs: SearchIndexDocument[]\n): SearchDocumentMap {\n const documents = new Map()\n const parents = new Set()\n for (const doc of docs) {\n const [path, hash] = doc.location.split(\"#\")\n\n /* Extract location, title and tags */\n const location = doc.location\n const title = doc.title\n const tags = doc.tags\n\n /* Escape and cleanup text */\n const text = escapeHTML(doc.text)\n .replace(/\\s+(?=[,.:;!?])/g, \"\")\n .replace(/\\s+/g, \" \")\n\n /* Handle section */\n if (hash) {\n const parent = documents.get(path)!\n\n /* Ignore first section, override article */\n if (!parents.has(parent)) {\n parent.title = doc.title\n parent.text = text\n\n /* Remember that we processed the article */\n parents.add(parent)\n\n /* Add subsequent section */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n parent\n })\n }\n\n /* Add article */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n ...tags && { tags }\n })\n }\n }\n return documents\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexConfig } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search index configuration\n * @param escape - Whether to escape HTML\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n config: SearchIndexConfig, escape: boolean\n): SearchHighlightFactoryFn {\n const separator = new RegExp(config.separator, \"img\")\n const highlight = (_: unknown, data: string, term: string) => {\n return `${data}${term}`\n }\n\n /* Return factory function */\n return (query: string) => {\n query = query\n .replace(/[\\s*+\\-:~^]+/g, \" \")\n .trim()\n\n /* Create search term match expression */\n const match = new RegExp(`(^|${config.separator})(${\n query\n .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n .replace(separator, \"|\")\n })`, \"img\")\n\n /* Highlight string value */\n return value => (\n escape\n ? escapeHTML(value)\n : value\n )\n .replace(match, highlight)\n .replace(/<\\/mark>(\\s+)]*>/img, \"$1\")\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search transformation function\n *\n * @param value - Query value\n *\n * @returns Transformed query value\n */\nexport type SearchTransformFn = (value: string) => string\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Default transformation function\n *\n * 1. Search for terms in quotation marks and prepend a `+` modifier to denote\n * that the resulting document must contain all terms, converting the query\n * to an `AND` query (as opposed to the default `OR` behavior). While users\n * may expect terms enclosed in quotation marks to map to span queries, i.e.\n * for which order is important, Lunr.js doesn't support them, so the best\n * we can do is to convert the terms to an `AND` query.\n *\n * 2. Replace control characters which are not located at the beginning of the\n * query or preceded by white space, or are not followed by a non-whitespace\n * character or are at the end of the query string. Furthermore, filter\n * unmatched quotation marks.\n *\n * 3. Trim excess whitespace from left and right.\n *\n * @param query - Query value\n *\n * @returns Transformed query value\n */\nexport function defaultTransform(query: string): string {\n return query\n .split(/\"([^\"]+)\"/g) /* => 1 */\n .map((terms, index) => index & 1\n ? terms.replace(/^\\b|^(?![^\\x00-\\x7F]|$)|\\s+/g, \" +\")\n : terms\n )\n .join(\"\")\n .replace(/\"|(?:^|\\s+)[*+\\-:^~]+(?=\\s+|$)/g, \"\") /* => 2 */\n .trim() /* => 3 */\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { SearchIndex, SearchResult } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search message type\n */\nexport const enum SearchMessageType {\n SETUP, /* Search index setup */\n READY, /* Search index ready */\n QUERY, /* Search query */\n RESULT /* Search results */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message containing the data necessary to setup the search index\n */\nexport interface SearchSetupMessage {\n type: SearchMessageType.SETUP /* Message type */\n data: SearchIndex /* Message data */\n}\n\n/**\n * Message indicating the search index is ready\n */\nexport interface SearchReadyMessage {\n type: SearchMessageType.READY /* Message type */\n}\n\n/**\n * Message containing a search query\n */\nexport interface SearchQueryMessage {\n type: SearchMessageType.QUERY /* Message type */\n data: string /* Message data */\n}\n\n/**\n * Message containing results for a search query\n */\nexport interface SearchResultMessage {\n type: SearchMessageType.RESULT /* Message type */\n data: SearchResult /* Message data */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Message exchanged with the search worker\n */\nexport type SearchMessage =\n | SearchSetupMessage\n | SearchReadyMessage\n | SearchQueryMessage\n | SearchResultMessage\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Type guard for search setup messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchSetupMessage(\n message: SearchMessage\n): message is SearchSetupMessage {\n return message.type === SearchMessageType.SETUP\n}\n\n/**\n * Type guard for search ready messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchReadyMessage(\n message: SearchMessage\n): message is SearchReadyMessage {\n return message.type === SearchMessageType.READY\n}\n\n/**\n * Type guard for search query messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchQueryMessage(\n message: SearchMessage\n): message is SearchQueryMessage {\n return message.type === SearchMessageType.QUERY\n}\n\n/**\n * Type guard for search result messages\n *\n * @param message - Search worker message\n *\n * @returns Test result\n */\nexport function isSearchResultMessage(\n message: SearchMessage\n): message is SearchResultMessage {\n return message.type === SearchMessageType.RESULT\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n ObservableInput,\n Subject,\n from,\n map,\n share\n} from \"rxjs\"\n\nimport { configuration, feature, translation } from \"~/_\"\nimport { WorkerHandler, watchWorker } from \"~/browser\"\n\nimport { SearchIndex } from \"../../_\"\nimport {\n SearchOptions,\n SearchPipeline\n} from \"../../options\"\nimport {\n SearchMessage,\n SearchMessageType,\n SearchSetupMessage,\n isSearchResultMessage\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search worker\n */\nexport type SearchWorker = WorkerHandler\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search index\n *\n * @param data - Search index\n *\n * @returns Search index\n */\nfunction setupSearchIndex({ config, docs }: SearchIndex): SearchIndex {\n\n /* Override default language with value from translation */\n if (config.lang.length === 1 && config.lang[0] === \"en\")\n config.lang = [\n translation(\"search.config.lang\")\n ]\n\n /* Override default separator with value from translation */\n if (config.separator === \"[\\\\s\\\\-]+\")\n config.separator = translation(\"search.config.separator\")\n\n /* Set pipeline from translation */\n const pipeline = translation(\"search.config.pipeline\")\n .split(/\\s*,\\s*/)\n .filter(Boolean) as SearchPipeline\n\n /* Determine search options */\n const options: SearchOptions = {\n pipeline,\n suggestions: feature(\"search.suggest\")\n }\n\n /* Return search index after defaulting */\n return { config, docs, options }\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up search worker\n *\n * This function creates a web worker to set up and query the search index,\n * which is done using Lunr.js. The index must be passed as an observable to\n * enable hacks like _localsearch_ via search index embedding as JSON.\n *\n * @param url - Worker URL\n * @param index - Search index observable input\n *\n * @returns Search worker\n */\nexport function setupSearchWorker(\n url: string, index: ObservableInput\n): SearchWorker {\n const config = configuration()\n const worker = new Worker(url)\n\n /* Create communication channels and resolve relative links */\n const tx$ = new Subject()\n const rx$ = watchWorker(worker, { tx$ })\n .pipe(\n map(message => {\n if (isSearchResultMessage(message)) {\n for (const result of message.data.items)\n for (const document of result)\n document.location = `${new URL(document.location, config.base)}`\n }\n return message\n }),\n share()\n )\n\n /* Set up search index */\n from(index)\n .pipe(\n map(data => ({\n type: SearchMessageType.SETUP,\n data: setupSearchIndex(data)\n } as SearchSetupMessage))\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Return search worker */\n return { tx$, rx$ }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Subject,\n catchError,\n combineLatest,\n filter,\n fromEvent,\n map,\n of,\n switchMap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n getElement,\n getLocation,\n requestJSON,\n setLocation\n} from \"~/browser\"\nimport { getComponentElements } from \"~/components\"\nimport {\n Version,\n renderVersionSelector\n} from \"~/templates\"\n\nimport { fetchSitemap } from \"../sitemap\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Setup options\n */\ninterface SetupOptions {\n document$: Subject /* Document subject */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Set up version selector\n *\n * @param options - Options\n */\nexport function setupVersionSelector(\n { document$ }: SetupOptions\n): void {\n const config = configuration()\n const versions$ = requestJSON(\n new URL(\"../versions.json\", config.base)\n )\n .pipe(\n catchError(() => EMPTY) // @todo refactor instant loading\n )\n\n /* Determine current version */\n const current$ = versions$\n .pipe(\n map(versions => {\n const [, current] = config.base.match(/([^/]+)\\/?$/)!\n return versions.find(({ version, aliases }) => (\n version === current || aliases.includes(current)\n )) || versions[0]\n })\n )\n\n /* Intercept inter-version navigation */\n versions$\n .pipe(\n map(versions => new Map(versions.map(version => [\n `${new URL(`../${version.version}/`, config.base)}`,\n version\n ]))),\n switchMap(urls => fromEvent(document.body, \"click\")\n .pipe(\n filter(ev => !ev.metaKey && !ev.ctrlKey),\n withLatestFrom(current$),\n switchMap(([ev, current]) => {\n if (ev.target instanceof Element) {\n const el = ev.target.closest(\"a\")\n if (el && !el.target && urls.has(el.href)) {\n const url = el.href\n // This is a temporary hack to detect if a version inside the\n // version selector or on another part of the site was clicked.\n // If we're inside the version selector, we definitely want to\n // find the same page, as we might have different deployments\n // due to aliases. However, if we're outside the version\n // selector, we must abort here, because we might otherwise\n // interfere with instant loading. We need to refactor this\n // at some point together with instant loading.\n //\n // See https://github.com/squidfunk/mkdocs-material/issues/4012\n if (!ev.target.closest(\".md-version\")) {\n const version = urls.get(url)!\n if (version === current)\n return EMPTY\n }\n ev.preventDefault()\n return of(url)\n }\n }\n return EMPTY\n }),\n switchMap(url => {\n const { version } = urls.get(url)!\n return fetchSitemap(new URL(url))\n .pipe(\n map(sitemap => {\n const location = getLocation()\n const path = location.href.replace(config.base, \"\")\n return sitemap.includes(path.split(\"#\")[0])\n ? new URL(`../${version}/${path}`, config.base)\n : new URL(url)\n })\n )\n })\n )\n )\n )\n .subscribe(url => setLocation(url))\n\n /* Render version selector and warning */\n combineLatest([versions$, current$])\n .subscribe(([versions, current]) => {\n const topic = getElement(\".md-header__topic\")\n topic.appendChild(renderVersionSelector(versions, current))\n })\n\n /* Integrate outdated version banner with instant loading */\n document$.pipe(switchMap(() => current$))\n .subscribe(current => {\n\n /* Check if version state was already determined */\n let outdated = __md_get(\"__outdated\", sessionStorage)\n if (outdated === null) {\n const latest = config.version?.default || \"latest\"\n outdated = !current.aliases.includes(latest)\n\n /* Persist version state in session storage */\n __md_set(\"__outdated\", outdated, sessionStorage)\n }\n\n /* Unhide outdated version banner */\n if (outdated)\n for (const warning of getComponentElements(\"outdated\"))\n warning.hidden = false\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n combineLatest,\n delay,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n finalize,\n fromEvent,\n map,\n merge,\n share,\n shareReplay,\n startWith,\n take,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n getLocation,\n setToggle,\n watchElementFocus,\n watchToggle\n} from \"~/browser\"\nimport {\n SearchMessageType,\n SearchQueryMessage,\n SearchWorker,\n defaultTransform,\n isSearchReadyMessage\n} from \"~/integrations\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query\n */\nexport interface SearchQuery {\n value: string /* Query value */\n focus: boolean /* Query focus */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch search query\n *\n * Note that the focus event which triggers re-reading the current query value\n * is delayed by `1ms` so the input's empty state is allowed to propagate.\n *\n * @param el - Search query element\n * @param worker - Search worker\n *\n * @returns Search query observable\n */\nexport function watchSearchQuery(\n el: HTMLInputElement, { rx$ }: SearchWorker\n): Observable {\n const fn = __search?.transform || defaultTransform\n\n /* Immediately show search dialog */\n const { searchParams } = getLocation()\n if (searchParams.has(\"q\"))\n setToggle(\"search\", true)\n\n /* Intercept query parameter (deep link) */\n const param$ = rx$\n .pipe(\n filter(isSearchReadyMessage),\n take(1),\n map(() => searchParams.get(\"q\") || \"\")\n )\n\n /* Remove query parameter when search is closed */\n watchToggle(\"search\")\n .pipe(\n filter(active => !active),\n take(1)\n )\n .subscribe(() => {\n const url = new URL(location.href)\n url.searchParams.delete(\"q\")\n history.replaceState({}, \"\", `${url}`)\n })\n\n /* Set query from parameter */\n param$.subscribe(value => { // TODO: not ideal - find a better way\n if (value) {\n el.value = value\n el.focus()\n }\n })\n\n /* Intercept focus and input events */\n const focus$ = watchElementFocus(el)\n const value$ = merge(\n fromEvent(el, \"keyup\"),\n fromEvent(el, \"focus\").pipe(delay(1)),\n param$\n )\n .pipe(\n map(() => fn(el.value)),\n startWith(\"\"),\n distinctUntilChanged(),\n )\n\n /* Combine into single observable */\n return combineLatest([value$, focus$])\n .pipe(\n map(([value, focus]) => ({ value, focus })),\n shareReplay(1)\n )\n}\n\n/**\n * Mount search query\n *\n * @param el - Search query element\n * @param worker - Search worker\n *\n * @returns Search query component observable\n */\nexport function mountSearchQuery(\n el: HTMLInputElement, { tx$, rx$ }: SearchWorker\n): Observable> {\n const push$ = new Subject()\n const done$ = push$.pipe(takeLast(1))\n\n /* Handle value changes */\n push$\n .pipe(\n distinctUntilKeyChanged(\"value\"),\n map(({ value }): SearchQueryMessage => ({\n type: SearchMessageType.QUERY,\n data: value\n }))\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Handle focus changes */\n push$\n .pipe(\n distinctUntilKeyChanged(\"focus\")\n )\n .subscribe(({ focus }) => {\n if (focus) {\n setToggle(\"search\", focus)\n el.placeholder = \"\"\n } else {\n el.placeholder = translation(\"search.placeholder\")\n }\n })\n\n /* Handle reset */\n fromEvent(el.form!, \"reset\")\n .pipe(\n takeUntil(done$)\n )\n .subscribe(() => el.focus())\n\n /* Create and return component */\n return watchSearchQuery(el, { tx$, rx$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state })),\n share()\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n filter,\n finalize,\n map,\n merge,\n of,\n skipUntil,\n switchMap,\n take,\n tap,\n withLatestFrom,\n zipWith\n} from \"rxjs\"\n\nimport { translation } from \"~/_\"\nimport {\n getElement,\n watchElementBoundary\n} from \"~/browser\"\nimport {\n SearchResult,\n SearchWorker,\n isSearchReadyMessage,\n isSearchResultMessage\n} from \"~/integrations\"\nimport { renderSearchResultItem } from \"~/templates\"\nimport { round } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n query$: Observable /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search result list\n *\n * This function performs a lazy rendering of the search results, depending on\n * the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param worker - Search worker\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchResult(\n el: HTMLElement, { rx$ }: SearchWorker, { query$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n const boundary$ = watchElementBoundary(el.parentElement!)\n .pipe(\n filter(Boolean)\n )\n\n /* Retrieve nested components */\n const meta = getElement(\":scope > :first-child\", el)\n const list = getElement(\":scope > :last-child\", el)\n\n /* Wait until search is ready */\n const ready$ = rx$\n .pipe(\n filter(isSearchReadyMessage),\n take(1)\n )\n\n /* Update search result metadata */\n push$\n .pipe(\n withLatestFrom(query$),\n skipUntil(ready$)\n )\n .subscribe(([{ items }, { value }]) => {\n if (value) {\n switch (items.length) {\n\n /* No results */\n case 0:\n meta.textContent = translation(\"search.result.none\")\n break\n\n /* One result */\n case 1:\n meta.textContent = translation(\"search.result.one\")\n break\n\n /* Multiple result */\n default:\n meta.textContent = translation(\n \"search.result.other\",\n round(items.length)\n )\n }\n } else {\n meta.textContent = translation(\"search.result.placeholder\")\n }\n })\n\n /* Update search result list */\n push$\n .pipe(\n tap(() => list.innerHTML = \"\"),\n switchMap(({ items }) => merge(\n of(...items.slice(0, 10)),\n of(...items.slice(10))\n .pipe(\n bufferCount(4),\n zipWith(boundary$),\n switchMap(([chunk]) => chunk)\n )\n ))\n )\n .subscribe(result => list.appendChild(\n renderSearchResultItem(result)\n ))\n\n /* Filter search result message */\n const result$ = rx$\n .pipe(\n filter(isSearchResultMessage),\n map(({ data }) => data)\n )\n\n /* Create and return component */\n return result$\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n finalize,\n fromEvent,\n map,\n tap\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\n\nimport { Component } from \"../../_\"\nimport { SearchQuery } from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search sharing\n */\nexport interface SearchShare {\n url: URL /* Deep link for sharing */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n query$: Observable /* Search query observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n query$: Observable /* Search query observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search sharing\n *\n * @param _el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing observable\n */\nexport function watchSearchShare(\n _el: HTMLElement, { query$ }: WatchOptions\n): Observable {\n return query$\n .pipe(\n map(({ value }) => {\n const url = getLocation()\n url.hash = \"\"\n url.searchParams.delete(\"h\")\n url.searchParams.set(\"q\", value)\n return { url }\n })\n )\n}\n\n/**\n * Mount search sharing\n *\n * @param el - Search sharing element\n * @param options - Options\n *\n * @returns Search sharing component observable\n */\nexport function mountSearchShare(\n el: HTMLAnchorElement, options: MountOptions\n): Observable> {\n const push$ = new Subject()\n push$.subscribe(({ url }) => {\n el.setAttribute(\"data-clipboard-text\", el.href)\n el.href = `${url}`\n })\n\n /* Prevent following of link */\n fromEvent(el, \"click\")\n .subscribe(ev => ev.preventDefault())\n\n /* Create and return component */\n return watchSearchShare(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n asyncScheduler,\n combineLatestWith,\n distinctUntilChanged,\n filter,\n finalize,\n fromEvent,\n map,\n merge,\n observeOn,\n tap\n} from \"rxjs\"\n\nimport { Keyboard } from \"~/browser\"\nimport {\n SearchResult,\n SearchWorker,\n isSearchResultMessage\n} from \"~/integrations\"\n\nimport { Component, getComponentElement } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search suggestions\n */\nexport interface SearchSuggest {}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n keyboard$: Observable /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search suggestions\n *\n * This function will perform a lazy rendering of the search results, depending\n * on the vertical offset of the search result container.\n *\n * @param el - Search result list element\n * @param worker - Search worker\n * @param options - Options\n *\n * @returns Search result list component observable\n */\nexport function mountSearchSuggest(\n el: HTMLElement, { rx$ }: SearchWorker, { keyboard$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n\n /* Retrieve query component and track all changes */\n const query = getComponentElement(\"search-query\")\n const query$ = merge(\n fromEvent(query, \"keydown\"),\n fromEvent(query, \"focus\")\n )\n .pipe(\n observeOn(asyncScheduler),\n map(() => query.value),\n distinctUntilChanged(),\n )\n\n /* Update search suggestions */\n push$\n .pipe(\n combineLatestWith(query$),\n map(([{ suggestions }, value]) => {\n const words = value.split(/([\\s-]+)/)\n if (suggestions?.length && words[words.length - 1]) {\n const last = suggestions[suggestions.length - 1]\n if (last.startsWith(words[words.length - 1]))\n words[words.length - 1] = last\n } else {\n words.length = 0\n }\n return words\n })\n )\n .subscribe(words => el.innerHTML = words\n .join(\"\")\n .replace(/\\s/g, \" \")\n )\n\n /* Set up search keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"search\")\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Right arrow: accept current suggestion */\n case \"ArrowRight\":\n if (\n el.innerText.length &&\n query.selectionStart === query.value.length\n )\n query.value = el.innerText\n break\n }\n })\n\n /* Filter search result message */\n const result$ = rx$\n .pipe(\n filter(isSearchResultMessage),\n map(({ data }) => data)\n )\n\n /* Create and return component */\n return result$\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(() => ({ ref: el }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n NEVER,\n Observable,\n ObservableInput,\n filter,\n merge,\n mergeWith,\n sample,\n take\n} from \"rxjs\"\n\nimport { configuration } from \"~/_\"\nimport {\n Keyboard,\n getActiveElement,\n getElements,\n setToggle\n} from \"~/browser\"\nimport {\n SearchIndex,\n SearchResult,\n isSearchQueryMessage,\n isSearchReadyMessage,\n setupSearchWorker\n} from \"~/integrations\"\n\nimport {\n Component,\n getComponentElement,\n getComponentElements\n} from \"../../_\"\nimport {\n SearchQuery,\n mountSearchQuery\n} from \"../query\"\nimport { mountSearchResult } from \"../result\"\nimport {\n SearchShare,\n mountSearchShare\n} from \"../share\"\nimport {\n SearchSuggest,\n mountSearchSuggest\n} from \"../suggest\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search\n */\nexport type Search =\n | SearchQuery\n | SearchResult\n | SearchShare\n | SearchSuggest\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n index$: ObservableInput /* Search index observable */\n keyboard$: Observable /* Keyboard observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search\n *\n * This function sets up the search functionality, including the underlying\n * web worker and all keyboard bindings.\n *\n * @param el - Search element\n * @param options - Options\n *\n * @returns Search component observable\n */\nexport function mountSearch(\n el: HTMLElement, { index$, keyboard$ }: MountOptions\n): Observable> {\n const config = configuration()\n try {\n const url = __search?.worker || config.search\n const worker = setupSearchWorker(url, index$)\n\n /* Retrieve query and result components */\n const query = getComponentElement(\"search-query\", el)\n const result = getComponentElement(\"search-result\", el)\n\n /* Re-emit query when search is ready */\n const { tx$, rx$ } = worker\n tx$\n .pipe(\n filter(isSearchQueryMessage),\n sample(rx$.pipe(filter(isSearchReadyMessage))),\n take(1)\n )\n .subscribe(tx$.next.bind(tx$))\n\n /* Set up search keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"search\")\n )\n .subscribe(key => {\n const active = getActiveElement()\n switch (key.type) {\n\n /* Enter: go to first (best) result */\n case \"Enter\":\n if (active === query) {\n const anchors = new Map()\n for (const anchor of getElements(\n \":first-child [href]\", result\n )) {\n const article = anchor.firstElementChild!\n anchors.set(anchor, parseFloat(\n article.getAttribute(\"data-md-score\")!\n ))\n }\n\n /* Go to result with highest score, if any */\n if (anchors.size) {\n const [[best]] = [...anchors].sort(([, a], [, b]) => b - a)\n best.click()\n }\n\n /* Otherwise omit form submission */\n key.claim()\n }\n break\n\n /* Escape or Tab: close search */\n case \"Escape\":\n case \"Tab\":\n setToggle(\"search\", false)\n query.blur()\n break\n\n /* Vertical arrows: select previous or next search result */\n case \"ArrowUp\":\n case \"ArrowDown\":\n if (typeof active === \"undefined\") {\n query.focus()\n } else {\n const els = [query, ...getElements(\n \":not(details) > [href], summary, details[open] [href]\",\n result\n )]\n const i = Math.max(0, (\n Math.max(0, els.indexOf(active)) + els.length + (\n key.type === \"ArrowUp\" ? -1 : +1\n )\n ) % els.length)\n els[i].focus()\n }\n\n /* Prevent scrolling of page */\n key.claim()\n break\n\n /* All other keys: hand to search query */\n default:\n if (query !== getActiveElement())\n query.focus()\n }\n })\n\n /* Set up global keyboard handlers */\n keyboard$\n .pipe(\n filter(({ mode }) => mode === \"global\"),\n )\n .subscribe(key => {\n switch (key.type) {\n\n /* Open search and select query */\n case \"f\":\n case \"s\":\n case \"/\":\n query.focus()\n query.select()\n\n /* Prevent scrolling of page */\n key.claim()\n break\n }\n })\n\n /* Create and return component */\n const query$ = mountSearchQuery(query, worker)\n const result$ = mountSearchResult(result, worker, { query$ })\n return merge(query$, result$)\n .pipe(\n mergeWith(\n\n /* Search sharing */\n ...getComponentElements(\"search-share\", el)\n .map(child => mountSearchShare(child, { query$ })),\n\n /* Search suggestions */\n ...getComponentElements(\"search-suggest\", el)\n .map(child => mountSearchSuggest(child, worker, { keyboard$ }))\n )\n )\n\n /* Gracefully handle broken search */\n } catch (err) {\n el.hidden = true\n return NEVER\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n ObservableInput,\n combineLatest,\n filter,\n map,\n startWith\n} from \"rxjs\"\n\nimport { getLocation } from \"~/browser\"\nimport {\n SearchIndex,\n setupSearchHighlighter\n} from \"~/integrations\"\nimport { h } from \"~/utilities\"\n\nimport { Component } from \"../../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlighting\n */\nexport interface SearchHighlight {\n nodes: Map /* Map of replacements */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount options\n */\ninterface MountOptions {\n index$: ObservableInput /* Search index observable */\n location$: Observable /* Location observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Mount search highlighting\n *\n * @param el - Content element\n * @param options - Options\n *\n * @returns Search highlighting component observable\n */\nexport function mountSearchHiglight(\n el: HTMLElement, { index$, location$ }: MountOptions\n): Observable> {\n return combineLatest([\n index$,\n location$\n .pipe(\n startWith(getLocation()),\n filter(url => !!url.searchParams.get(\"h\"))\n )\n ])\n .pipe(\n map(([index, url]) => setupSearchHighlighter(index.config, true)(\n url.searchParams.get(\"h\")!\n )),\n map(fn => {\n const nodes = new Map()\n\n /* Traverse text nodes and collect matches */\n const it = document.createNodeIterator(el, NodeFilter.SHOW_TEXT)\n for (let node = it.nextNode(); node; node = it.nextNode()) {\n if (node.parentElement?.offsetHeight) {\n const original = node.textContent!\n const replaced = fn(original)\n if (replaced.length > original.length)\n nodes.set(node as ChildNode, replaced)\n }\n }\n\n /* Replace original nodes with matches */\n for (const [node, text] of nodes) {\n const { childNodes } = h(\"span\", null, text)\n node.replaceWith(...Array.from(childNodes))\n }\n\n /* Return component */\n return { ref: el, nodes }\n })\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n animationFrameScheduler,\n auditTime,\n combineLatest,\n defer,\n distinctUntilChanged,\n finalize,\n map,\n observeOn,\n take,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport {\n Viewport,\n getElement,\n getElementContainer,\n getElementOffset,\n getElementSize,\n getElements\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Sidebar\n */\nexport interface Sidebar {\n height: number /* Sidebar height */\n locked: boolean /* Sidebar is locked */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n main$: Observable
    /* Main area observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch sidebar\n *\n * This function returns an observable that computes the visual parameters of\n * the sidebar which depends on the vertical viewport offset, as well as the\n * height of the main area. When the page is scrolled beyond the header, the\n * sidebar is locked and fills the remaining space.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar observable\n */\nexport function watchSidebar(\n el: HTMLElement, { viewport$, main$ }: WatchOptions\n): Observable {\n const parent = el.parentElement!\n const adjust =\n parent.offsetTop -\n parent.parentElement!.offsetTop\n\n /* Compute the sidebar's available height and if it should be locked */\n return combineLatest([main$, viewport$])\n .pipe(\n map(([{ offset, height }, { offset: { y } }]) => {\n height = height\n + Math.min(adjust, Math.max(0, y - offset))\n - adjust\n return {\n height,\n locked: y >= offset + adjust\n }\n }),\n distinctUntilChanged((a, b) => (\n a.height === b.height &&\n a.locked === b.locked\n ))\n )\n}\n\n/**\n * Mount sidebar\n *\n * This function doesn't set the height of the actual sidebar, but of its first\n * child \u2013 the `.md-sidebar__scrollwrap` element in order to mitigiate jittery\n * sidebars when the footer is scrolled into view. At some point we switched\n * from `absolute` / `fixed` positioning to `sticky` positioning, significantly\n * reducing jitter in some browsers (respectively Firefox and Safari) when\n * scrolling from the top. However, top-aligned sticky positioning means that\n * the sidebar snaps to the bottom when the end of the container is reached.\n * This is what leads to the mentioned jitter, as the sidebar's height may be\n * updated too slowly.\n *\n * This behaviour can be mitigiated by setting the height of the sidebar to `0`\n * while preserving the padding, and the height on its first element.\n *\n * @param el - Sidebar element\n * @param options - Options\n *\n * @returns Sidebar component observable\n */\nexport function mountSidebar(\n el: HTMLElement, { header$, ...options }: MountOptions\n): Observable> {\n const inner = getElement(\".md-sidebar__scrollwrap\", el)\n const { y } = getElementOffset(inner)\n return defer(() => {\n const push$ = new Subject()\n push$\n .pipe(\n auditTime(0, animationFrameScheduler),\n withLatestFrom(header$)\n )\n .subscribe({\n\n /* Handle emission */\n next([{ height }, { height: offset }]) {\n inner.style.height = `${height - 2 * y}px`\n el.style.top = `${offset}px`\n },\n\n /* Handle complete */\n complete() {\n inner.style.height = \"\"\n el.style.top = \"\"\n }\n })\n\n /* Bring active item into view on initial load */\n push$\n .pipe(\n observeOn(animationFrameScheduler),\n take(1)\n )\n .subscribe(() => {\n for (const item of getElements(\".md-nav__link--active[href]\", el)) {\n const container = getElementContainer(item)\n if (typeof container !== \"undefined\") {\n const offset = item.offsetTop - container.offsetTop\n const { height } = getElementSize(container)\n container.scrollTo({\n top: offset - height / 2\n })\n }\n }\n })\n\n /* Create and return component */\n return watchSidebar(el, options)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { Repo, User } from \"github-types\"\nimport {\n EMPTY,\n Observable,\n catchError,\n defaultIfEmpty,\n map,\n zip\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * GitHub release (partial)\n */\ninterface Release {\n tag_name: string /* Tag name */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitHub repository facts\n *\n * @param user - GitHub user or organization\n * @param repo - GitHub repository\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitHub(\n user: string, repo?: string\n): Observable {\n if (typeof repo !== \"undefined\") {\n const url = `https://api.github.com/repos/${user}/${repo}`\n return zip(\n\n /* Fetch version */\n requestJSON(`${url}/releases/latest`)\n .pipe(\n catchError(() => EMPTY), // @todo refactor instant loading\n map(release => ({\n version: release.tag_name\n })),\n defaultIfEmpty({})\n ),\n\n /* Fetch stars and forks */\n requestJSON(url)\n .pipe(\n catchError(() => EMPTY), // @todo refactor instant loading\n map(info => ({\n stars: info.stargazers_count,\n forks: info.forks_count\n })),\n defaultIfEmpty({})\n )\n )\n .pipe(\n map(([release, info]) => ({ ...release, ...info }))\n )\n\n /* User or organization */\n } else {\n const url = `https://api.github.com/users/${user}`\n return requestJSON(url)\n .pipe(\n map(info => ({\n repositories: info.public_repos\n })),\n defaultIfEmpty({})\n )\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { ProjectSchema } from \"gitlab\"\nimport {\n EMPTY,\n Observable,\n catchError,\n defaultIfEmpty,\n map\n} from \"rxjs\"\n\nimport { requestJSON } from \"~/browser\"\n\nimport { SourceFacts } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch GitLab repository facts\n *\n * @param base - GitLab base\n * @param project - GitLab project\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFactsFromGitLab(\n base: string, project: string\n): Observable {\n const url = `https://${base}/api/v4/projects/${encodeURIComponent(project)}`\n return requestJSON(url)\n .pipe(\n catchError(() => EMPTY), // @todo refactor instant loading\n map(({ star_count, forks_count }) => ({\n stars: star_count,\n forks: forks_count\n })),\n defaultIfEmpty({})\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport { EMPTY, Observable } from \"rxjs\"\n\nimport { fetchSourceFactsFromGitHub } from \"../github\"\nimport { fetchSourceFactsFromGitLab } from \"../gitlab\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository facts for repositories\n */\nexport interface RepositoryFacts {\n stars?: number /* Number of stars */\n forks?: number /* Number of forks */\n version?: string /* Latest version */\n}\n\n/**\n * Repository facts for organizations\n */\nexport interface OrganizationFacts {\n repositories?: number /* Number of repositories */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Repository facts\n */\nexport type SourceFacts =\n | RepositoryFacts\n | OrganizationFacts\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch repository facts\n *\n * @param url - Repository URL\n *\n * @returns Repository facts observable\n */\nexport function fetchSourceFacts(\n url: string\n): Observable {\n const [type] = url.match(/(git(?:hub|lab))/i) || []\n switch (type.toLowerCase()) {\n\n /* GitHub repository */\n case \"github\":\n const [, user, repo] = url.match(/^.+github\\.com\\/([^/]+)\\/?([^/]+)?/i)!\n return fetchSourceFactsFromGitHub(user, repo)\n\n /* GitLab repository */\n case \"gitlab\":\n const [, base, slug] = url.match(/^.+?([^/]*gitlab[^/]+)\\/(.+?)\\/?$/i)!\n return fetchSourceFactsFromGitLab(base, slug)\n\n /* Everything else */\n default:\n return EMPTY\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n EMPTY,\n Observable,\n Subject,\n catchError,\n defer,\n filter,\n finalize,\n map,\n of,\n shareReplay,\n tap\n} from \"rxjs\"\n\nimport { getElement } from \"~/browser\"\nimport { ConsentDefaults } from \"~/components/consent\"\nimport { renderSourceFacts } from \"~/templates\"\n\nimport {\n Component,\n getComponentElements\n} from \"../../_\"\nimport {\n SourceFacts,\n fetchSourceFacts\n} from \"../facts\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information\n */\nexport interface Source {\n facts: SourceFacts /* Repository facts */\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Repository information observable\n */\nlet fetch$: Observable\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch repository information\n *\n * This function tries to read the repository facts from session storage, and\n * if unsuccessful, fetches them from the underlying provider.\n *\n * @param el - Repository information element\n *\n * @returns Repository information observable\n */\nexport function watchSource(\n el: HTMLAnchorElement\n): Observable {\n return fetch$ ||= defer(() => {\n const cached = __md_get(\"__source\", sessionStorage)\n if (cached) {\n return of(cached)\n } else {\n\n /* Check if consent is configured and was given */\n const els = getComponentElements(\"consent\")\n if (els.length) {\n const consent = __md_get(\"__consent\")\n if (!(consent && consent.github))\n return EMPTY\n }\n\n /* Fetch repository facts */\n return fetchSourceFacts(el.href)\n .pipe(\n tap(facts => __md_set(\"__source\", facts, sessionStorage))\n )\n }\n })\n .pipe(\n catchError(() => EMPTY),\n filter(facts => Object.keys(facts).length > 0),\n map(facts => ({ facts })),\n shareReplay(1)\n )\n}\n\n/**\n * Mount repository information\n *\n * @param el - Repository information element\n *\n * @returns Repository information component observable\n */\nexport function mountSource(\n el: HTMLAnchorElement\n): Observable> {\n const inner = getElement(\":scope > :last-child\", el)\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe(({ facts }) => {\n inner.appendChild(renderSourceFacts(facts))\n inner.classList.add(\"md-source__repository--active\")\n })\n\n /* Create and return component */\n return watchSource(el)\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n defer,\n distinctUntilKeyChanged,\n finalize,\n map,\n of,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n watchElementSize,\n watchViewportAt\n} from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Navigation tabs\n */\nexport interface Tabs {\n hidden: boolean /* Navigation tabs are hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch navigation tabs\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs observable\n */\nexport function watchTabs(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n return watchElementSize(document.body)\n .pipe(\n switchMap(() => watchViewportAt(el, { header$, viewport$ })),\n map(({ offset: { y } }) => {\n return {\n hidden: y >= 10\n }\n }),\n distinctUntilKeyChanged(\"hidden\")\n )\n}\n\n/**\n * Mount navigation tabs\n *\n * This function hides the navigation tabs when scrolling past the threshold\n * and makes them reappear in a nice CSS animation when scrolling back up.\n *\n * @param el - Navigation tabs element\n * @param options - Options\n *\n * @returns Navigation tabs component observable\n */\nexport function mountTabs(\n el: HTMLElement, options: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n push$.subscribe({\n\n /* Handle emission */\n next({ hidden }) {\n el.hidden = hidden\n },\n\n /* Handle complete */\n complete() {\n el.hidden = false\n }\n })\n\n /* Create and return component */\n return (\n feature(\"navigation.tabs.sticky\")\n ? of({ hidden: false })\n : watchTabs(el, options)\n )\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatestWith,\n debounceTime,\n defer,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n filter,\n finalize,\n map,\n merge,\n of,\n repeat,\n scan,\n share,\n skip,\n startWith,\n switchMap,\n takeLast,\n takeUntil,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { feature } from \"~/_\"\nimport {\n Viewport,\n getElement,\n getElementContainer,\n getElementSize,\n getElements,\n getLocation,\n getOptionalElement,\n watchElementSize\n} from \"~/browser\"\n\nimport {\n Component,\n getComponentElement\n} from \"../_\"\nimport { Header } from \"../header\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Table of contents\n */\nexport interface TableOfContents {\n prev: HTMLAnchorElement[][] /* Anchors (previous) */\n next: HTMLAnchorElement[][] /* Anchors (next) */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n target$: Observable /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch table of contents\n *\n * This is effectively a scroll spy implementation which will account for the\n * fixed header and automatically re-calculate anchor offsets when the viewport\n * is resized. The returned observable will only emit if the table of contents\n * needs to be repainted.\n *\n * This implementation tracks an anchor element's entire path starting from its\n * level up to the top-most anchor element, e.g. `[h3, h2, h1]`. Although the\n * Material theme currently doesn't make use of this information, it enables\n * the styling of the entire hierarchy through customization.\n *\n * Note that the current anchor is the last item of the `prev` anchor list.\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents observable\n */\nexport function watchTableOfContents(\n el: HTMLElement, { viewport$, header$ }: WatchOptions\n): Observable {\n const table = new Map()\n\n /* Compute anchor-to-target mapping */\n const anchors = getElements(\"[href^=\\\\#]\", el)\n for (const anchor of anchors) {\n const id = decodeURIComponent(anchor.hash.substring(1))\n const target = getOptionalElement(`[id=\"${id}\"]`)\n if (typeof target !== \"undefined\")\n table.set(anchor, target)\n }\n\n /* Compute necessary adjustment for header */\n const adjust$ = header$\n .pipe(\n distinctUntilKeyChanged(\"height\"),\n map(({ height }) => {\n const main = getComponentElement(\"main\")\n const grid = getElement(\":scope > :first-child\", main)\n return height + 0.8 * (\n grid.offsetTop -\n main.offsetTop\n )\n }),\n share()\n )\n\n /* Compute partition of previous and next anchors */\n const partition$ = watchElementSize(document.body)\n .pipe(\n distinctUntilKeyChanged(\"height\"),\n\n /* Build index to map anchor paths to vertical offsets */\n switchMap(body => defer(() => {\n let path: HTMLAnchorElement[] = []\n return of([...table].reduce((index, [anchor, target]) => {\n while (path.length) {\n const last = table.get(path[path.length - 1])!\n if (last.tagName >= target.tagName) {\n path.pop()\n } else {\n break\n }\n }\n\n /* If the current anchor is hidden, continue with its parent */\n let offset = target.offsetTop\n while (!offset && target.parentElement) {\n target = target.parentElement\n offset = target.offsetTop\n }\n\n /* Map reversed anchor path to vertical offset */\n return index.set(\n [...path = [...path, anchor]].reverse(),\n offset\n )\n }, new Map()))\n })\n .pipe(\n\n /* Sort index by vertical offset (see https://bit.ly/30z6QSO) */\n map(index => new Map([...index].sort(([, a], [, b]) => a - b))),\n combineLatestWith(adjust$),\n\n /* Re-compute partition when viewport offset changes */\n switchMap(([index, adjust]) => viewport$\n .pipe(\n scan(([prev, next], { offset: { y }, size }) => {\n const last = y + size.height >= Math.floor(body.height)\n\n /* Look forward */\n while (next.length) {\n const [, offset] = next[0]\n if (offset - adjust < y || last) {\n prev = [...prev, next.shift()!]\n } else {\n break\n }\n }\n\n /* Look backward */\n while (prev.length) {\n const [, offset] = prev[prev.length - 1]\n if (offset - adjust >= y && !last) {\n next = [prev.pop()!, ...next]\n } else {\n break\n }\n }\n\n /* Return partition */\n return [prev, next]\n }, [[], [...index]]),\n distinctUntilChanged((a, b) => (\n a[0] === b[0] &&\n a[1] === b[1]\n ))\n )\n )\n )\n )\n )\n\n /* Compute and return anchor list migrations */\n return partition$\n .pipe(\n map(([prev, next]) => ({\n prev: prev.map(([path]) => path),\n next: next.map(([path]) => path)\n })),\n\n /* Extract anchor list migrations */\n startWith({ prev: [], next: [] }),\n bufferCount(2, 1),\n map(([a, b]) => {\n\n /* Moving down */\n if (a.prev.length < b.prev.length) {\n return {\n prev: b.prev.slice(Math.max(0, a.prev.length - 1), b.prev.length),\n next: []\n }\n\n /* Moving up */\n } else {\n return {\n prev: b.prev.slice(-1),\n next: b.next.slice(0, b.next.length - a.next.length)\n }\n }\n })\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount table of contents\n *\n * @param el - Table of contents element\n * @param options - Options\n *\n * @returns Table of contents component observable\n */\nexport function mountTableOfContents(\n el: HTMLElement, { viewport$, header$, target$ }: MountOptions\n): Observable> {\n return defer(() => {\n const push$ = new Subject()\n const done$ = push$.pipe(takeLast(1))\n push$.subscribe(({ prev, next }) => {\n\n /* Look forward */\n for (const [anchor] of next) {\n anchor.classList.remove(\"md-nav__link--passed\")\n anchor.classList.remove(\"md-nav__link--active\")\n }\n\n /* Look backward */\n for (const [index, [anchor]] of prev.entries()) {\n anchor.classList.add(\"md-nav__link--passed\")\n anchor.classList.toggle(\n \"md-nav__link--active\",\n index === prev.length - 1\n )\n }\n })\n\n /* Set up following, if enabled */\n if (feature(\"toc.follow\")) {\n\n /* Toggle smooth scrolling only for anchor clicks */\n const smooth$ = merge(\n viewport$.pipe(debounceTime(1), map(() => undefined)),\n viewport$.pipe(debounceTime(250), map(() => \"smooth\" as const))\n )\n\n /* Bring active anchor into view */\n push$\n .pipe(\n filter(({ prev }) => prev.length > 0),\n withLatestFrom(smooth$)\n )\n .subscribe(([{ prev }, behavior]) => {\n const [anchor] = prev[prev.length - 1]\n if (anchor.offsetHeight) {\n\n /* Retrieve overflowing container and scroll */\n const container = getElementContainer(anchor)\n if (typeof container !== \"undefined\") {\n const offset = anchor.offsetTop - container.offsetTop\n const { height } = getElementSize(container)\n container.scrollTo({\n top: offset - height / 2,\n behavior\n })\n }\n }\n })\n }\n\n /* Set up anchor tracking, if enabled */\n if (feature(\"navigation.tracking\"))\n viewport$\n .pipe(\n takeUntil(done$),\n distinctUntilKeyChanged(\"offset\"),\n debounceTime(250),\n skip(1),\n takeUntil(target$.pipe(skip(1))),\n repeat({ delay: 250 }),\n withLatestFrom(push$)\n )\n .subscribe(([, { prev }]) => {\n const url = getLocation()\n\n /* Set hash fragment to active anchor */\n const anchor = prev[prev.length - 1]\n if (anchor && anchor.length) {\n const [active] = anchor\n const { hash } = new URL(active.href)\n if (url.hash !== hash) {\n url.hash = hash\n history.replaceState({}, \"\", `${url}`)\n }\n\n /* Reset anchor when at the top */\n } else {\n url.hash = \"\"\n history.replaceState({}, \"\", `${url}`)\n }\n })\n\n /* Create and return component */\n return watchTableOfContents(el, { viewport$, header$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n Subject,\n bufferCount,\n combineLatest,\n distinctUntilChanged,\n distinctUntilKeyChanged,\n endWith,\n finalize,\n map,\n repeat,\n skip,\n takeLast,\n takeUntil,\n tap\n} from \"rxjs\"\n\nimport { Viewport } from \"~/browser\"\n\nimport { Component } from \"../_\"\nimport { Header } from \"../header\"\nimport { Main } from \"../main\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Back-to-top button\n */\nexport interface BackToTop {\n hidden: boolean /* Back-to-top button is hidden */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch options\n */\ninterface WatchOptions {\n viewport$: Observable /* Viewport observable */\n main$: Observable
    /* Main area observable */\n target$: Observable /* Location target observable */\n}\n\n/**\n * Mount options\n */\ninterface MountOptions {\n viewport$: Observable /* Viewport observable */\n header$: Observable
    /* Header observable */\n main$: Observable
    /* Main area observable */\n target$: Observable /* Location target observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Watch back-to-top\n *\n * @param _el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top observable\n */\nexport function watchBackToTop(\n _el: HTMLElement, { viewport$, main$, target$ }: WatchOptions\n): Observable {\n\n /* Compute direction */\n const direction$ = viewport$\n .pipe(\n map(({ offset: { y } }) => y),\n bufferCount(2, 1),\n map(([a, b]) => a > b && b > 0),\n distinctUntilChanged()\n )\n\n /* Compute whether main area is active */\n const active$ = main$\n .pipe(\n map(({ active }) => active)\n )\n\n /* Compute threshold for hiding */\n return combineLatest([active$, direction$])\n .pipe(\n map(([active, direction]) => !(active && direction)),\n distinctUntilChanged(),\n takeUntil(target$.pipe(skip(1))),\n endWith(true),\n repeat({ delay: 250 }),\n map(hidden => ({ hidden }))\n )\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Mount back-to-top\n *\n * @param el - Back-to-top element\n * @param options - Options\n *\n * @returns Back-to-top component observable\n */\nexport function mountBackToTop(\n el: HTMLElement, { viewport$, header$, main$, target$ }: MountOptions\n): Observable> {\n const push$ = new Subject()\n const done$ = push$.pipe(takeLast(1))\n push$.subscribe({\n\n /* Handle emission */\n next({ hidden }) {\n el.hidden = hidden\n if (hidden) {\n el.setAttribute(\"tabindex\", \"-1\")\n el.blur()\n } else {\n el.removeAttribute(\"tabindex\")\n }\n },\n\n /* Handle complete */\n complete() {\n el.style.top = \"\"\n el.hidden = true\n el.removeAttribute(\"tabindex\")\n }\n })\n\n /* Watch header height */\n header$\n .pipe(\n takeUntil(done$),\n distinctUntilKeyChanged(\"height\")\n )\n .subscribe(({ height }) => {\n el.style.top = `${height + 16}px`\n })\n\n /* Create and return component */\n return watchBackToTop(el, { viewport$, main$, target$ })\n .pipe(\n tap(state => push$.next(state)),\n finalize(() => push$.complete()),\n map(state => ({ ref: el, ...state }))\n )\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n fromEvent,\n map,\n mergeMap,\n switchMap,\n takeWhile,\n tap,\n withLatestFrom\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n document$: Observable /* Document observable */\n tablet$: Observable /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch indeterminate checkboxes\n *\n * This function replaces the indeterminate \"pseudo state\" with the actual\n * indeterminate state, which is used to keep navigation always expanded.\n *\n * @param options - Options\n */\nexport function patchIndeterminate(\n { document$, tablet$ }: PatchOptions\n): void {\n document$\n .pipe(\n switchMap(() => getElements(\n // @todo `data-md-state` is deprecated and removed in v9\n \".md-toggle--indeterminate, [data-md-state=indeterminate]\"\n )),\n tap(el => {\n el.indeterminate = true\n el.checked = false\n }),\n mergeMap(el => fromEvent(el, \"change\")\n .pipe(\n takeWhile(() => el.classList.contains(\"md-toggle--indeterminate\")),\n map(() => el)\n )\n ),\n withLatestFrom(tablet$)\n )\n .subscribe(([el, tablet]) => {\n el.classList.remove(\"md-toggle--indeterminate\")\n if (tablet)\n el.checked = false\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n filter,\n fromEvent,\n map,\n mergeMap,\n switchMap,\n tap\n} from \"rxjs\"\n\nimport { getElements } from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n document$: Observable /* Document observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Check whether the given device is an Apple device\n *\n * @returns Test result\n */\nfunction isAppleDevice(): boolean {\n return /(iPad|iPhone|iPod)/.test(navigator.userAgent)\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch all elements with `data-md-scrollfix` attributes\n *\n * This is a year-old patch which ensures that overflow scrolling works at the\n * top and bottom of containers on iOS by ensuring a `1px` scroll offset upon\n * the start of a touch event.\n *\n * @see https://bit.ly/2SCtAOO - Original source\n *\n * @param options - Options\n */\nexport function patchScrollfix(\n { document$ }: PatchOptions\n): void {\n document$\n .pipe(\n switchMap(() => getElements(\"[data-md-scrollfix]\")),\n tap(el => el.removeAttribute(\"data-md-scrollfix\")),\n filter(isAppleDevice),\n mergeMap(el => fromEvent(el, \"touchstart\")\n .pipe(\n map(() => el)\n )\n )\n )\n .subscribe(el => {\n const top = el.scrollTop\n\n /* We're at the top of the container */\n if (top === 0) {\n el.scrollTop = 1\n\n /* We're at the bottom of the container */\n } else if (top + el.offsetHeight === el.scrollHeight) {\n el.scrollTop = top - 1\n }\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n Observable,\n combineLatest,\n delay,\n map,\n of,\n switchMap,\n withLatestFrom\n} from \"rxjs\"\n\nimport {\n Viewport,\n watchToggle\n} from \"~/browser\"\n\n/* ----------------------------------------------------------------------------\n * Helper types\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch options\n */\ninterface PatchOptions {\n viewport$: Observable /* Viewport observable */\n tablet$: Observable /* Media tablet observable */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Patch the document body to lock when search is open\n *\n * For mobile and tablet viewports, the search is rendered full screen, which\n * leads to scroll leaking when at the top or bottom of the search result. This\n * function locks the body when the search is in full screen mode, and restores\n * the scroll position when leaving.\n *\n * @param options - Options\n */\nexport function patchScrolllock(\n { viewport$, tablet$ }: PatchOptions\n): void {\n combineLatest([watchToggle(\"search\"), tablet$])\n .pipe(\n map(([active, tablet]) => active && !tablet),\n switchMap(active => of(active)\n .pipe(\n delay(active ? 400 : 100)\n )\n ),\n withLatestFrom(viewport$)\n )\n .subscribe(([active, { offset: { y }}]) => {\n if (active) {\n document.body.setAttribute(\"data-md-scrolllock\", \"\")\n document.body.style.top = `-${y}px`\n } else {\n const value = -1 * parseInt(document.body.style.top, 10)\n document.body.removeAttribute(\"data-md-scrolllock\")\n document.body.style.top = \"\"\n if (value)\n window.scrollTo(0, value)\n }\n })\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n Object.entries = function (obj: object) {\n const data: [string, string][] = []\n for (const key of Object.keys(obj))\n // @ts-expect-error - ignore property access warning\n data.push([key, obj[key]])\n\n /* Return entries */\n return data\n }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n Object.values = function (obj: object) {\n const data: string[] = []\n for (const key of Object.keys(obj))\n // @ts-expect-error - ignore property access warning\n data.push(obj[key])\n\n /* Return values */\n return data\n }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n /* Polyfill `Element.scrollTo` */\n if (!Element.prototype.scrollTo)\n Element.prototype.scrollTo = function (\n x?: ScrollToOptions | number, y?: number\n ): void {\n if (typeof x === \"object\") {\n this.scrollLeft = x.left!\n this.scrollTop = x.top!\n } else {\n this.scrollLeft = x!\n this.scrollTop = y!\n }\n }\n\n /* Polyfill `Element.replaceWith` */\n if (!Element.prototype.replaceWith)\n Element.prototype.replaceWith = function (\n ...nodes: Array\n ): void {\n const parent = this.parentNode\n if (parent) {\n if (nodes.length === 0)\n parent.removeChild(this)\n\n /* Replace children and create text nodes */\n for (let i = nodes.length - 1; i >= 0; i--) {\n let node = nodes[i]\n if (typeof node !== \"object\")\n node = document.createTextNode(node)\n else if (node.parentNode)\n node.parentNode.removeChild(node)\n\n /* Replace child or insert before previous sibling */\n if (!i)\n parent.replaceChild(node, this)\n else\n parent.insertBefore(this.previousSibling!, node)\n }\n }\n }\n}\n"], + "mappings": "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", + "names": ["require_focus_visible", "__commonJSMin", "exports", "module", "global", "factory", "applyFocusVisiblePolyfill", "scope", "hadKeyboardEvent", "hadFocusVisibleRecently", "hadFocusVisibleRecentlyTimeout", "inputTypesAllowlist", "isValidFocusTarget", "el", "focusTriggersKeyboardModality", "type", "tagName", "addFocusVisibleClass", "removeFocusVisibleClass", "onKeyDown", "e", "onPointerDown", "onFocus", "onBlur", "onVisibilityChange", "addInitialPointerMoveListeners", "onInitialPointerMove", "removeInitialPointerMoveListeners", "event", "error", "require_url_polyfill", "__commonJSMin", "exports", "global", "checkIfIteratorIsSupported", "error", "iteratorSupported", "createIterator", "items", "iterator", "value", "serializeParam", "deserializeParam", "polyfillURLSearchParams", "URLSearchParams", "searchString", "typeofSearchString", "_this", "name", "i", "entry", "key", "proto", "callback", "thisArg", "entries", "searchArray", "checkIfURLSearchParamsSupported", "e", "a", "b", "keys", "attributes", "attribute", "checkIfURLIsSupported", "u", "polyfillURL", "_URL", "URL", "url", "base", "doc", "baseElement", "err", "anchorElement", "inputElement", "searchParams", "enableSearchUpdate", "enableSearchParamsUpdate", "methodName", "method", "search", "linkURLWithAnchorAttribute", "attributeName", "expectedPort", "addPortToOrigin", "blob", "getOrigin", "require_tslib", "__commonJSMin", "exports", "module", "__extends", "__assign", "__rest", "__decorate", "__param", "__metadata", "__awaiter", "__generator", "__exportStar", "__values", "__read", "__spread", "__spreadArrays", "__spreadArray", "__await", "__asyncGenerator", "__asyncDelegator", "__asyncValues", "__makeTemplateObject", "__importStar", "__importDefault", "__classPrivateFieldGet", "__classPrivateFieldSet", "__createBinding", "factory", "root", "createExporter", "previous", "id", "v", "exporter", "extendStatics", "d", "b", "p", "__", "t", "s", "n", "e", "i", "decorators", "target", "key", "desc", "c", "r", "paramIndex", "decorator", "metadataKey", "metadataValue", "thisArg", "_arguments", "P", "generator", "adopt", "value", "resolve", "reject", "fulfilled", "step", "rejected", "result", "body", "_", "f", "y", "g", "verb", "op", "m", "o", "k", "k2", "ar", "error", "il", "a", "j", "jl", "to", "from", "pack", "l", "q", "resume", "settle", "fulfill", "cooked", "raw", "__setModuleDefault", "mod", "receiver", "state", "kind", "require_clipboard", "__commonJSMin", "exports", "module", "root", "factory", "__webpack_modules__", "__unused_webpack_module", "__webpack_exports__", "__webpack_require__", "clipboard", "tiny_emitter", "tiny_emitter_default", "listen", "listen_default", "src_select", "select_default", "command", "type", "err", "ClipboardActionCut", "target", "selectedText", "actions_cut", "createFakeElement", "value", "isRTL", "fakeElement", "yPosition", "fakeCopyAction", "options", "ClipboardActionCopy", "actions_copy", "_typeof", "obj", "ClipboardActionDefault", "_options$action", "action", "container", "text", "actions_default", "clipboard_typeof", "_classCallCheck", "instance", "Constructor", "_defineProperties", "props", "i", "descriptor", "_createClass", "protoProps", "staticProps", "_inherits", "subClass", "superClass", "_setPrototypeOf", "o", "p", "_createSuper", "Derived", "hasNativeReflectConstruct", "_isNativeReflectConstruct", "Super", "_getPrototypeOf", "result", "NewTarget", "_possibleConstructorReturn", "self", "call", "_assertThisInitialized", "e", "getAttributeValue", "suffix", "element", "attribute", "Clipboard", "_Emitter", "_super", "trigger", "_this", "_this2", "selector", "actions", "support", "DOCUMENT_NODE_TYPE", "proto", "closest", "__unused_webpack_exports", "_delegate", "callback", "useCapture", "listenerFn", "listener", "delegate", "elements", "is", "listenNode", "listenNodeList", "listenSelector", "node", "nodeList", "select", "isReadOnly", "selection", "range", "E", "name", "ctx", "data", "evtArr", "len", "evts", "liveEvents", "__webpack_module_cache__", "moduleId", "getter", "definition", "key", "prop", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "r", "a", "e", "import_focus_visible", "n", "t", "s", "r", "o", "u", "i", "a", "e", "c", "import_url_polyfill", "import_tslib", "__extends", "__assign", "__rest", "__decorate", "__param", "__metadata", "__awaiter", "__generator", "__exportStar", "__createBinding", "__values", "__read", "__spread", "__spreadArrays", "__spreadArray", "__await", "__asyncGenerator", "__asyncDelegator", "__asyncValues", "__makeTemplateObject", "__importStar", "__importDefault", "__classPrivateFieldGet", "__classPrivateFieldSet", "tslib", "isFunction", "value", "createErrorClass", "createImpl", "_super", "instance", "ctorFunc", "UnsubscriptionError", "createErrorClass", "_super", "errors", "err", "i", "arrRemove", "arr", "item", "index", "Subscription", "initialTeardown", "errors", "_parentage", "_parentage_1", "__values", "_parentage_1_1", "parent_1", "initialFinalizer", "isFunction", "e", "UnsubscriptionError", "_finalizers", "_finalizers_1", "_finalizers_1_1", "finalizer", "execFinalizer", "err", "__spreadArray", "__read", "teardown", "_a", "parent", "arrRemove", "empty", "EMPTY_SUBSCRIPTION", "Subscription", "isSubscription", "value", "isFunction", "execFinalizer", "finalizer", "config", "timeoutProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "reportUnhandledError", "err", "timeoutProvider", "onUnhandledError", "config", "noop", "COMPLETE_NOTIFICATION", "createNotification", "errorNotification", "error", "nextNotification", "value", "kind", "context", "errorContext", "cb", "config", "isRoot", "_a", "errorThrown", "error", "captureError", "err", "Subscriber", "_super", "__extends", "destination", "_this", "isSubscription", "EMPTY_OBSERVER", "next", "error", "complete", "SafeSubscriber", "value", "handleStoppedNotification", "nextNotification", "err", "errorNotification", "COMPLETE_NOTIFICATION", "Subscription", "_bind", "bind", "fn", "thisArg", "ConsumerObserver", "partialObserver", "value", "error", "handleUnhandledError", "err", "SafeSubscriber", "_super", "__extends", "observerOrNext", "complete", "_this", "isFunction", "context_1", "config", "Subscriber", "handleUnhandledError", "error", "config", "captureError", "reportUnhandledError", "defaultErrorHandler", "err", "handleStoppedNotification", "notification", "subscriber", "onStoppedNotification", "timeoutProvider", "EMPTY_OBSERVER", "noop", "observable", "identity", "x", "pipe", "fns", "_i", "pipeFromArray", "identity", "input", "prev", "fn", "Observable", "subscribe", "operator", "observable", "observerOrNext", "error", "complete", "_this", "subscriber", "isSubscriber", "SafeSubscriber", "errorContext", "_a", "source", "sink", "err", "next", "promiseCtor", "getPromiseCtor", "resolve", "reject", "value", "operations", "_i", "pipeFromArray", "x", "getPromiseCtor", "promiseCtor", "_a", "config", "isObserver", "value", "isFunction", "isSubscriber", "Subscriber", "isSubscription", "hasLift", "source", "isFunction", "operate", "init", "liftedSource", "err", "createOperatorSubscriber", "destination", "onNext", "onComplete", "onError", "onFinalize", "OperatorSubscriber", "_super", "__extends", "shouldUnsubscribe", "_this", "value", "err", "closed_1", "_a", "Subscriber", "animationFrameProvider", "callback", "request", "cancel", "delegate", "handle", "timestamp", "Subscription", "args", "_i", "__spreadArray", "__read", "ObjectUnsubscribedError", "createErrorClass", "_super", "Subject", "_super", "__extends", "_this", "operator", "subject", "AnonymousSubject", "ObjectUnsubscribedError", "value", "errorContext", "_b", "__values", "_c", "observer", "err", "observers", "_a", "subscriber", "hasError", "isStopped", "EMPTY_SUBSCRIPTION", "Subscription", "arrRemove", "thrownError", "observable", "Observable", "destination", "source", "AnonymousSubject", "_super", "__extends", "destination", "source", "_this", "value", "_b", "_a", "err", "subscriber", "EMPTY_SUBSCRIPTION", "Subject", "dateTimestampProvider", "ReplaySubject", "_super", "__extends", "_bufferSize", "_windowTime", "_timestampProvider", "dateTimestampProvider", "_this", "value", "_a", "isStopped", "_buffer", "_infiniteTimeWindow", "subscriber", "subscription", "copy", "i", "adjustedBufferSize", "now", "last", "Subject", "Action", "_super", "__extends", "scheduler", "work", "state", "delay", "Subscription", "intervalProvider", "handler", "timeout", "args", "_i", "delegate", "__spreadArray", "__read", "handle", "AsyncAction", "_super", "__extends", "scheduler", "work", "_this", "state", "delay", "id", "_a", "_id", "intervalProvider", "_scheduler", "error", "_delay", "errored", "errorValue", "e", "actions", "arrRemove", "Action", "Scheduler", "schedulerActionCtor", "now", "work", "delay", "state", "dateTimestampProvider", "AsyncScheduler", "_super", "__extends", "SchedulerAction", "now", "Scheduler", "_this", "action", "actions", "error", "asyncScheduler", "AsyncScheduler", "AsyncAction", "async", "AnimationFrameAction", "_super", "__extends", "scheduler", "work", "_this", "id", "delay", "animationFrameProvider", "actions", "_a", "AsyncAction", "AnimationFrameScheduler", "_super", "__extends", "action", "flushId", "actions", "error", "AsyncScheduler", "animationFrameScheduler", "AnimationFrameScheduler", "AnimationFrameAction", "EMPTY", "Observable", "subscriber", "isScheduler", "value", "isFunction", "last", "arr", "popResultSelector", "args", "isFunction", "popScheduler", "isScheduler", "popNumber", "defaultValue", "isArrayLike", "x", "isPromise", "value", "isFunction", "isInteropObservable", "input", "isFunction", "observable", "isAsyncIterable", "obj", "isFunction", "createInvalidObservableTypeError", "input", "getSymbolIterator", "iterator", "isIterable", "input", "isFunction", "iterator", "readableStreamLikeToAsyncGenerator", "readableStream", "reader", "__await", "_a", "_b", "value", "done", "isReadableStreamLike", "obj", "isFunction", "innerFrom", "input", "Observable", "isInteropObservable", "fromInteropObservable", "isArrayLike", "fromArrayLike", "isPromise", "fromPromise", "isAsyncIterable", "fromAsyncIterable", "isIterable", "fromIterable", "isReadableStreamLike", "fromReadableStreamLike", "createInvalidObservableTypeError", "obj", "subscriber", "obs", "observable", "isFunction", "array", "i", "promise", "value", "err", "reportUnhandledError", "iterable", "iterable_1", "__values", "iterable_1_1", "asyncIterable", "process", "readableStream", "readableStreamLikeToAsyncGenerator", "asyncIterable_1", "__asyncValues", "asyncIterable_1_1", "executeSchedule", "parentSubscription", "scheduler", "work", "delay", "repeat", "scheduleSubscription", "observeOn", "scheduler", "delay", "operate", "source", "subscriber", "createOperatorSubscriber", "value", "executeSchedule", "err", "subscribeOn", "scheduler", "delay", "operate", "source", "subscriber", "scheduleObservable", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "schedulePromise", "input", "scheduler", "innerFrom", "subscribeOn", "observeOn", "scheduleArray", "input", "scheduler", "Observable", "subscriber", "i", "scheduleIterable", "input", "scheduler", "Observable", "subscriber", "iterator", "executeSchedule", "value", "done", "_a", "err", "isFunction", "scheduleAsyncIterable", "input", "scheduler", "Observable", "subscriber", "executeSchedule", "iterator", "result", "scheduleReadableStreamLike", "input", "scheduler", "scheduleAsyncIterable", "readableStreamLikeToAsyncGenerator", "scheduled", "input", "scheduler", "isInteropObservable", "scheduleObservable", "isArrayLike", "scheduleArray", "isPromise", "schedulePromise", "isAsyncIterable", "scheduleAsyncIterable", "isIterable", "scheduleIterable", "isReadableStreamLike", "scheduleReadableStreamLike", "createInvalidObservableTypeError", "from", "input", "scheduler", "scheduled", "innerFrom", "of", "args", "_i", "scheduler", "popScheduler", "from", "throwError", "errorOrErrorFactory", "scheduler", "errorFactory", "isFunction", "init", "subscriber", "Observable", "isValidDate", "value", "map", "project", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "isArray", "callOrApply", "fn", "args", "__spreadArray", "__read", "mapOneOrManyArgs", "map", "isArray", "getPrototypeOf", "objectProto", "getKeys", "argsArgArrayOrObject", "args", "first_1", "isPOJO", "keys", "key", "obj", "createObject", "keys", "values", "result", "key", "i", "combineLatest", "args", "_i", "scheduler", "popScheduler", "resultSelector", "popResultSelector", "_a", "argsArgArrayOrObject", "observables", "keys", "from", "result", "Observable", "combineLatestInit", "values", "createObject", "identity", "mapOneOrManyArgs", "valueTransform", "subscriber", "maybeSchedule", "length", "active", "remainingFirstValues", "i", "source", "hasFirstValue", "createOperatorSubscriber", "value", "execute", "subscription", "executeSchedule", "mergeInternals", "source", "subscriber", "project", "concurrent", "onBeforeNext", "expand", "innerSubScheduler", "additionalFinalizer", "buffer", "active", "index", "isComplete", "checkComplete", "outerNext", "value", "doInnerSub", "innerComplete", "innerFrom", "createOperatorSubscriber", "innerValue", "bufferedValue", "executeSchedule", "err", "mergeMap", "project", "resultSelector", "concurrent", "isFunction", "a", "i", "map", "b", "ii", "innerFrom", "operate", "source", "subscriber", "mergeInternals", "mergeAll", "concurrent", "mergeMap", "identity", "concatAll", "mergeAll", "concat", "args", "_i", "concatAll", "from", "popScheduler", "defer", "observableFactory", "Observable", "subscriber", "innerFrom", "nodeEventEmitterMethods", "eventTargetMethods", "jqueryMethods", "fromEvent", "target", "eventName", "options", "resultSelector", "isFunction", "mapOneOrManyArgs", "_a", "__read", "isEventTarget", "methodName", "handler", "isNodeStyleEventEmitter", "toCommonHandlerRegistry", "isJQueryStyleEventEmitter", "add", "remove", "isArrayLike", "mergeMap", "subTarget", "innerFrom", "Observable", "subscriber", "args", "_i", "fromEventPattern", "addHandler", "removeHandler", "resultSelector", "mapOneOrManyArgs", "Observable", "subscriber", "handler", "e", "_i", "retValue", "isFunction", "timer", "dueTime", "intervalOrScheduler", "scheduler", "async", "intervalDuration", "isScheduler", "Observable", "subscriber", "due", "isValidDate", "n", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "sources", "innerFrom", "mergeAll", "from", "EMPTY", "NEVER", "Observable", "noop", "isArray", "argsOrArgArray", "args", "filter", "predicate", "thisArg", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "zip", "args", "_i", "resultSelector", "popResultSelector", "sources", "argsOrArgArray", "Observable", "subscriber", "buffers", "completed", "sourceIndex", "innerFrom", "createOperatorSubscriber", "value", "buffer", "result", "__spreadArray", "__read", "i", "EMPTY", "audit", "durationSelector", "operate", "source", "subscriber", "hasValue", "lastValue", "durationSubscriber", "isComplete", "endDuration", "value", "cleanupDuration", "createOperatorSubscriber", "innerFrom", "auditTime", "duration", "scheduler", "asyncScheduler", "audit", "timer", "bufferCount", "bufferSize", "startBufferEvery", "operate", "source", "subscriber", "buffers", "count", "createOperatorSubscriber", "value", "toEmit", "buffers_1", "__values", "buffers_1_1", "buffer", "toEmit_1", "toEmit_1_1", "arrRemove", "buffers_2", "buffers_2_1", "catchError", "selector", "operate", "source", "subscriber", "innerSub", "syncUnsub", "handledResult", "createOperatorSubscriber", "err", "innerFrom", "scanInternals", "accumulator", "seed", "hasSeed", "emitOnNext", "emitBeforeComplete", "source", "subscriber", "hasState", "state", "index", "createOperatorSubscriber", "value", "i", "combineLatest", "args", "_i", "resultSelector", "popResultSelector", "pipe", "__spreadArray", "__read", "mapOneOrManyArgs", "operate", "source", "subscriber", "combineLatestInit", "argsOrArgArray", "combineLatestWith", "otherSources", "_i", "combineLatest", "__spreadArray", "__read", "concatMap", "project", "resultSelector", "isFunction", "mergeMap", "debounceTime", "dueTime", "scheduler", "asyncScheduler", "operate", "source", "subscriber", "activeTask", "lastValue", "lastTime", "emit", "value", "emitWhenIdle", "targetTime", "now", "createOperatorSubscriber", "defaultIfEmpty", "defaultValue", "operate", "source", "subscriber", "hasValue", "createOperatorSubscriber", "value", "take", "count", "EMPTY", "operate", "source", "subscriber", "seen", "createOperatorSubscriber", "value", "ignoreElements", "operate", "source", "subscriber", "createOperatorSubscriber", "noop", "mapTo", "value", "map", "delayWhen", "delayDurationSelector", "subscriptionDelay", "source", "concat", "take", "ignoreElements", "mergeMap", "value", "index", "mapTo", "delay", "due", "scheduler", "asyncScheduler", "duration", "timer", "delayWhen", "distinctUntilChanged", "comparator", "keySelector", "identity", "defaultCompare", "operate", "source", "subscriber", "previousKey", "first", "createOperatorSubscriber", "value", "currentKey", "a", "b", "distinctUntilKeyChanged", "key", "compare", "distinctUntilChanged", "x", "y", "endWith", "values", "_i", "source", "concat", "of", "__spreadArray", "__read", "finalize", "callback", "operate", "source", "subscriber", "takeLast", "count", "EMPTY", "operate", "source", "subscriber", "buffer", "createOperatorSubscriber", "value", "buffer_1", "__values", "buffer_1_1", "merge", "args", "_i", "scheduler", "popScheduler", "concurrent", "popNumber", "argsOrArgArray", "operate", "source", "subscriber", "mergeAll", "from", "__spreadArray", "__read", "mergeWith", "otherSources", "_i", "merge", "__spreadArray", "__read", "repeat", "countOrConfig", "count", "delay", "_a", "EMPTY", "operate", "source", "subscriber", "soFar", "sourceSub", "resubscribe", "notifier", "timer", "innerFrom", "notifierSubscriber_1", "createOperatorSubscriber", "subscribeToSource", "syncUnsub", "sample", "notifier", "operate", "source", "subscriber", "hasValue", "lastValue", "createOperatorSubscriber", "value", "noop", "scan", "accumulator", "seed", "operate", "scanInternals", "share", "options", "_a", "connector", "Subject", "_b", "resetOnError", "_c", "resetOnComplete", "_d", "resetOnRefCountZero", "wrapperSource", "connection", "resetConnection", "subject", "refCount", "hasCompleted", "hasErrored", "cancelReset", "reset", "resetAndUnsubscribe", "conn", "operate", "source", "subscriber", "dest", "handleReset", "SafeSubscriber", "value", "err", "innerFrom", "on", "args", "_i", "onSubscriber", "__spreadArray", "__read", "shareReplay", "configOrBufferSize", "windowTime", "scheduler", "bufferSize", "refCount", "_a", "_b", "_c", "share", "ReplaySubject", "skip", "count", "filter", "_", "index", "skipUntil", "notifier", "operate", "source", "subscriber", "taking", "skipSubscriber", "createOperatorSubscriber", "noop", "innerFrom", "value", "startWith", "values", "_i", "scheduler", "popScheduler", "operate", "source", "subscriber", "concat", "switchMap", "project", "resultSelector", "operate", "source", "subscriber", "innerSubscriber", "index", "isComplete", "checkComplete", "createOperatorSubscriber", "value", "innerIndex", "outerIndex", "innerFrom", "innerValue", "takeUntil", "notifier", "operate", "source", "subscriber", "innerFrom", "createOperatorSubscriber", "noop", "takeWhile", "predicate", "inclusive", "operate", "source", "subscriber", "index", "createOperatorSubscriber", "value", "result", "tap", "observerOrNext", "error", "complete", "tapObserver", "isFunction", "operate", "source", "subscriber", "_a", "isUnsub", "createOperatorSubscriber", "value", "err", "_b", "identity", "defaultThrottleConfig", "throttle", "durationSelector", "config", "operate", "source", "subscriber", "leading", "trailing", "hasValue", "sendValue", "throttled", "isComplete", "endThrottling", "send", "cleanupThrottling", "startThrottle", "value", "innerFrom", "createOperatorSubscriber", "throttleTime", "duration", "scheduler", "config", "asyncScheduler", "defaultThrottleConfig", "duration$", "timer", "throttle", "withLatestFrom", "inputs", "_i", "project", "popResultSelector", "operate", "source", "subscriber", "len", "otherValues", "hasValue", "ready", "i", "innerFrom", "createOperatorSubscriber", "value", "identity", "noop", "values", "__spreadArray", "__read", "zip", "sources", "_i", "operate", "source", "subscriber", "__spreadArray", "__read", "zipWith", "otherInputs", "_i", "zip", "__spreadArray", "__read", "watchDocument", "document$", "ReplaySubject", "fromEvent", "getElements", "selector", "node", "getElement", "el", "getOptionalElement", "getActiveElement", "watchElementFocus", "el", "merge", "fromEvent", "debounceTime", "map", "active", "getActiveElement", "startWith", "distinctUntilChanged", "getElementOffset", "el", "watchElementOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "getElementContentOffset", "el", "watchElementContentOffset", "merge", "fromEvent", "auditTime", "animationFrameScheduler", "map", "startWith", "MapShim", "getIndex", "arr", "key", "result", "entry", "index", "class_1", "value", "entries", "callback", "ctx", "_i", "_a", "isBrowser", "global$1", "requestAnimationFrame$1", "trailingTimeout", "throttle", "delay", "leadingCall", "trailingCall", "lastCallTime", "resolvePending", "proxy", "timeoutCallback", "timeStamp", "REFRESH_DELAY", "transitionKeys", "mutationObserverSupported", "ResizeObserverController", "observer", "observers", "changesDetected", "activeObservers", "_b", "propertyName", "isReflowProperty", "defineConfigurable", "target", "props", "getWindowOf", "ownerGlobal", "emptyRect", "createRectInit", "toFloat", "getBordersSize", "styles", "positions", "size", "position", "getPaddings", "paddings", "positions_1", "getSVGContentRect", "bbox", "getHTMLElementContentRect", "clientWidth", "clientHeight", "horizPad", "vertPad", "width", "height", "isDocumentElement", "vertScrollbar", "horizScrollbar", "isSVGGraphicsElement", "getContentRect", "createReadOnlyRect", "x", "y", "Constr", "rect", "ResizeObservation", "ResizeObserverEntry", "rectInit", "contentRect", "ResizeObserverSPI", "controller", "callbackCtx", "observations", "_this", "observation", "ResizeObserver", "method", "ResizeObserver_es_default", "entry$", "Subject", "observer$", "defer", "of", "ResizeObserver_es_default", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "getElementSize", "el", "watchElementSize", "tap", "filter", "target", "map", "startWith", "getElementContentSize", "el", "getElementContainer", "parent", "entry$", "Subject", "observer$", "defer", "of", "entries", "entry", "switchMap", "observer", "merge", "NEVER", "finalize", "shareReplay", "watchElementVisibility", "el", "tap", "filter", "target", "map", "isIntersecting", "watchElementBoundary", "threshold", "watchElementContentOffset", "y", "visible", "getElementSize", "content", "getElementContentSize", "distinctUntilChanged", "toggles", "getElement", "getToggle", "name", "setToggle", "value", "watchToggle", "el", "fromEvent", "map", "startWith", "isSusceptibleToKeyboard", "el", "type", "watchKeyboard", "fromEvent", "filter", "ev", "map", "getToggle", "mode", "active", "getActiveElement", "share", "getLocation", "setLocation", "url", "watchLocation", "Subject", "appendChild", "el", "child", "node", "h", "tag", "attributes", "children", "attr", "truncate", "value", "n", "i", "round", "digits", "getLocationHash", "setLocationHash", "hash", "el", "h", "ev", "watchLocationHash", "fromEvent", "map", "startWith", "filter", "shareReplay", "watchLocationTarget", "id", "getOptionalElement", "watchMedia", "query", "media", "fromEventPattern", "next", "startWith", "watchPrint", "merge", "fromEvent", "map", "at", "query$", "factory", "switchMap", "active", "EMPTY", "request", "url", "options", "from", "catchError", "EMPTY", "switchMap", "res", "throwError", "of", "requestJSON", "shareReplay", "requestXML", "dom", "map", "watchScript", "src", "script", "h", "defer", "merge", "fromEvent", "switchMap", "throwError", "map", "finalize", "take", "getViewportOffset", "watchViewportOffset", "merge", "fromEvent", "map", "startWith", "getViewportSize", "watchViewportSize", "fromEvent", "map", "startWith", "watchViewport", "combineLatest", "watchViewportOffset", "watchViewportSize", "map", "offset", "size", "shareReplay", "watchViewportAt", "el", "viewport$", "header$", "size$", "distinctUntilKeyChanged", "offset$", "combineLatest", "map", "getElementOffset", "height", "offset", "size", "x", "y", "watchWorker", "worker", "tx$", "rx$", "fromEvent", "map", "data", "throttle", "tap", "message", "switchMap", "share", "script", "getElement", "config", "getLocation", "configuration", "feature", "flag", "translation", "key", "value", "getComponentElement", "type", "node", "getElement", "getComponentElements", "getElements", "watchAnnounce", "el", "button", "getElement", "fromEvent", "map", "content", "mountAnnounce", "feature", "EMPTY", "defer", "push$", "Subject", "startWith", "hash", "_a", "tap", "state", "finalize", "__spreadValues", "watchConsent", "el", "target$", "map", "target", "mountConsent", "options", "internal$", "Subject", "hidden", "tap", "state", "finalize", "__spreadValues", "import_clipboard", "renderTooltip", "id", "h", "renderAnnotation", "id", "prefix", "anchor", "h", "renderTooltip", "renderClipboardButton", "id", "h", "translation", "renderSearchDocument", "document", "flag", "parent", "teaser", "missing", "key", "list", "h", "url", "feature", "match", "highlight", "value", "tags", "configuration", "truncate", "tag", "id", "type", "translation", "renderSearchResultItem", "result", "threshold", "docs", "doc", "article", "index", "best", "more", "children", "section", "renderSourceFacts", "facts", "h", "key", "value", "round", "renderTabbedControl", "type", "classes", "h", "renderTable", "table", "h", "renderVersion", "version", "config", "configuration", "url", "h", "renderVersionSelector", "versions", "active", "translation", "watchAnnotation", "el", "container", "offset$", "defer", "combineLatest", "watchElementOffset", "watchElementContentOffset", "map", "x", "y", "scroll", "width", "height", "getElementSize", "watchElementFocus", "switchMap", "active", "offset", "take", "mountAnnotation", "target$", "tooltip", "index", "push$", "Subject", "done$", "takeLast", "watchElementVisibility", "takeUntil", "visible", "merge", "filter", "debounceTime", "auditTime", "animationFrameScheduler", "throttleTime", "origin", "fromEvent", "ev", "withLatestFrom", "_a", "parent", "getActiveElement", "target", "delay", "tap", "state", "finalize", "__spreadValues", "findAnnotationMarkers", "container", "markers", "el", "getElements", "nodes", "it", "node", "text", "match", "id", "force", "marker", "swap", "source", "target", "mountAnnotationList", "target$", "print$", "parent", "prefix", "annotations", "getOptionalElement", "renderAnnotation", "EMPTY", "defer", "done$", "Subject", "pairs", "annotation", "getElement", "takeUntil", "takeLast", "active", "inner", "child", "merge", "mountAnnotation", "finalize", "share", "sequence", "findCandidateList", "el", "sibling", "watchCodeBlock", "watchElementSize", "map", "width", "getElementContentSize", "distinctUntilKeyChanged", "mountCodeBlock", "options", "hover", "factory$", "defer", "push$", "Subject", "scrollable", "ClipboardJS", "parent", "renderClipboardButton", "container", "list", "feature", "annotations$", "mountAnnotationList", "tap", "state", "finalize", "__spreadValues", "mergeWith", "height", "distinctUntilChanged", "switchMap", "active", "EMPTY", "watchElementVisibility", "filter", "visible", "take", "mermaid$", "sequence", "fetchScripts", "watchScript", "of", "mountMermaid", "el", "tap", "mermaid_default", "map", "shareReplay", "id", "host", "h", "svg", "shadow", "watchDetails", "el", "target$", "print$", "open", "merge", "map", "target", "filter", "details", "active", "tap", "mountDetails", "options", "defer", "push$", "Subject", "action", "reveal", "state", "finalize", "__spreadValues", "sentinel", "h", "mountDataTable", "el", "renderTable", "of", "watchContentTabs", "el", "inputs", "getElements", "initial", "input", "merge", "fromEvent", "map", "getElement", "startWith", "active", "mountContentTabs", "viewport$", "prev", "renderTabbedControl", "next", "container", "defer", "push$", "Subject", "done$", "takeLast", "combineLatest", "watchElementSize", "auditTime", "animationFrameScheduler", "takeUntil", "size", "offset", "getElementOffset", "width", "getElementSize", "content", "getElementContentOffset", "watchElementContentOffset", "getElementContentSize", "direction", "feature", "skip", "withLatestFrom", "tab", "y", "set", "label", "tabs", "tap", "state", "finalize", "__spreadValues", "subscribeOn", "asyncScheduler", "mountContent", "el", "viewport$", "target$", "print$", "merge", "getElements", "child", "mountCodeBlock", "mountMermaid", "mountDataTable", "mountDetails", "mountContentTabs", "watchDialog", "_el", "alert$", "switchMap", "message", "merge", "of", "delay", "map", "active", "mountDialog", "el", "options", "inner", "getElement", "defer", "push$", "Subject", "tap", "state", "finalize", "__spreadValues", "isHidden", "viewport$", "feature", "of", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilKeyChanged", "hidden$", "combineLatest", "filter", "offset", "direction", "distinctUntilChanged", "search$", "watchToggle", "search", "switchMap", "active", "startWith", "watchHeader", "el", "options", "defer", "watchElementSize", "height", "hidden", "shareReplay", "mountHeader", "header$", "main$", "push$", "Subject", "done$", "takeLast", "combineLatestWith", "takeUntil", "state", "__spreadValues", "watchHeaderTitle", "el", "viewport$", "header$", "watchViewportAt", "map", "y", "height", "getElementSize", "distinctUntilKeyChanged", "mountHeaderTitle", "options", "defer", "push$", "Subject", "active", "heading", "getOptionalElement", "EMPTY", "tap", "state", "finalize", "__spreadValues", "watchMain", "el", "viewport$", "header$", "adjust$", "map", "height", "distinctUntilChanged", "border$", "switchMap", "watchElementSize", "distinctUntilKeyChanged", "combineLatest", "header", "top", "bottom", "y", "a", "b", "watchPalette", "inputs", "current", "input", "of", "mergeMap", "fromEvent", "map", "startWith", "shareReplay", "mountPalette", "el", "defer", "push$", "Subject", "palette", "key", "value", "index", "label", "observeOn", "asyncScheduler", "getElements", "tap", "state", "finalize", "__spreadValues", "import_clipboard", "extract", "el", "text", "setupClipboardJS", "alert$", "ClipboardJS", "Observable", "subscriber", "getElement", "ev", "tap", "map", "translation", "preprocess", "urls", "root", "next", "a", "b", "url", "index", "fetchSitemap", "base", "cached", "of", "config", "configuration", "requestXML", "map", "sitemap", "getElements", "node", "catchError", "EMPTY", "defaultIfEmpty", "tap", "setupInstantLoading", "document$", "location$", "viewport$", "config", "configuration", "fromEvent", "favicon", "getOptionalElement", "push$", "fetchSitemap", "map", "paths", "path", "switchMap", "urls", "filter", "ev", "el", "url", "of", "NEVER", "share", "pop$", "merge", "distinctUntilChanged", "a", "b", "response$", "distinctUntilKeyChanged", "request", "catchError", "setLocation", "sample", "dom", "res", "skip", "replacement", "selector", "feature", "source", "target", "getComponentElement", "getElements", "concatMap", "script", "h", "name", "Observable", "observer", "EMPTY", "offset", "setLocationHash", "skipUntil", "debounceTime", "bufferCount", "state", "import_escape_html", "import_escape_html", "setupSearchHighlighter", "config", "escape", "separator", "highlight", "_", "data", "term", "query", "match", "value", "escapeHTML", "defaultTransform", "query", "terms", "index", "isSearchReadyMessage", "message", "isSearchQueryMessage", "isSearchResultMessage", "setupSearchIndex", "config", "docs", "translation", "options", "feature", "setupSearchWorker", "url", "index", "configuration", "worker", "tx$", "Subject", "rx$", "watchWorker", "map", "message", "isSearchResultMessage", "result", "document", "share", "from", "data", "setupVersionSelector", "document$", "config", "configuration", "versions$", "requestJSON", "catchError", "EMPTY", "current$", "map", "versions", "current", "version", "aliases", "switchMap", "urls", "fromEvent", "filter", "ev", "withLatestFrom", "el", "url", "of", "fetchSitemap", "sitemap", "path", "getLocation", "setLocation", "combineLatest", "getElement", "renderVersionSelector", "_a", "outdated", "latest", "warning", "getComponentElements", "watchSearchQuery", "el", "rx$", "fn", "defaultTransform", "searchParams", "getLocation", "setToggle", "param$", "filter", "isSearchReadyMessage", "take", "map", "watchToggle", "active", "url", "value", "focus$", "watchElementFocus", "value$", "merge", "fromEvent", "delay", "startWith", "distinctUntilChanged", "combineLatest", "focus", "shareReplay", "mountSearchQuery", "tx$", "push$", "Subject", "done$", "takeLast", "distinctUntilKeyChanged", "translation", "takeUntil", "tap", "state", "finalize", "__spreadValues", "share", "mountSearchResult", "el", "rx$", "query$", "push$", "Subject", "boundary$", "watchElementBoundary", "filter", "meta", "getElement", "list", "ready$", "isSearchReadyMessage", "take", "withLatestFrom", "skipUntil", "items", "value", "translation", "round", "tap", "switchMap", "merge", "of", "bufferCount", "zipWith", "chunk", "result", "renderSearchResultItem", "isSearchResultMessage", "map", "data", "state", "finalize", "__spreadValues", "watchSearchShare", "_el", "query$", "map", "value", "url", "getLocation", "mountSearchShare", "el", "options", "push$", "Subject", "fromEvent", "ev", "tap", "state", "finalize", "__spreadValues", "mountSearchSuggest", "el", "rx$", "keyboard$", "push$", "Subject", "query", "getComponentElement", "query$", "merge", "fromEvent", "observeOn", "asyncScheduler", "map", "distinctUntilChanged", "combineLatestWith", "suggestions", "value", "words", "last", "filter", "mode", "key", "isSearchResultMessage", "data", "tap", "state", "finalize", "mountSearch", "el", "index$", "keyboard$", "config", "configuration", "url", "worker", "setupSearchWorker", "query", "getComponentElement", "result", "tx$", "rx$", "filter", "isSearchQueryMessage", "sample", "isSearchReadyMessage", "take", "mode", "key", "active", "getActiveElement", "anchors", "anchor", "getElements", "article", "best", "a", "b", "setToggle", "els", "i", "query$", "mountSearchQuery", "result$", "mountSearchResult", "merge", "mergeWith", "getComponentElements", "child", "mountSearchShare", "mountSearchSuggest", "err", "NEVER", "mountSearchHiglight", "el", "index$", "location$", "combineLatest", "startWith", "getLocation", "filter", "url", "map", "index", "setupSearchHighlighter", "fn", "_a", "nodes", "it", "node", "original", "replaced", "text", "childNodes", "h", "watchSidebar", "el", "viewport$", "main$", "parent", "adjust", "combineLatest", "map", "offset", "height", "y", "distinctUntilChanged", "a", "b", "mountSidebar", "_a", "_b", "header$", "options", "__objRest", "inner", "getElement", "getElementOffset", "defer", "push$", "Subject", "auditTime", "animationFrameScheduler", "withLatestFrom", "observeOn", "take", "item", "getElements", "container", "getElementContainer", "getElementSize", "tap", "state", "finalize", "__spreadValues", "fetchSourceFactsFromGitHub", "user", "repo", "url", "zip", "requestJSON", "catchError", "EMPTY", "map", "release", "defaultIfEmpty", "info", "__spreadValues", "fetchSourceFactsFromGitLab", "base", "project", "url", "requestJSON", "catchError", "EMPTY", "map", "star_count", "forks_count", "defaultIfEmpty", "fetchSourceFacts", "url", "type", "user", "repo", "fetchSourceFactsFromGitHub", "base", "slug", "fetchSourceFactsFromGitLab", "EMPTY", "fetch$", "watchSource", "el", "defer", "cached", "of", "getComponentElements", "consent", "EMPTY", "fetchSourceFacts", "tap", "facts", "catchError", "filter", "map", "shareReplay", "mountSource", "inner", "getElement", "push$", "Subject", "renderSourceFacts", "state", "finalize", "__spreadValues", "watchTabs", "el", "viewport$", "header$", "watchElementSize", "switchMap", "watchViewportAt", "map", "y", "distinctUntilKeyChanged", "mountTabs", "options", "defer", "push$", "Subject", "hidden", "feature", "of", "tap", "state", "finalize", "__spreadValues", "watchTableOfContents", "el", "viewport$", "header$", "table", "anchors", "getElements", "anchor", "id", "target", "getOptionalElement", "adjust$", "distinctUntilKeyChanged", "map", "height", "main", "getComponentElement", "grid", "getElement", "share", "watchElementSize", "switchMap", "body", "defer", "path", "of", "index", "offset", "a", "b", "combineLatestWith", "adjust", "scan", "prev", "next", "y", "size", "last", "distinctUntilChanged", "startWith", "bufferCount", "mountTableOfContents", "target$", "push$", "Subject", "done$", "takeLast", "feature", "smooth$", "merge", "debounceTime", "filter", "withLatestFrom", "behavior", "container", "getElementContainer", "getElementSize", "takeUntil", "skip", "repeat", "url", "getLocation", "active", "hash", "tap", "state", "finalize", "__spreadValues", "watchBackToTop", "_el", "viewport$", "main$", "target$", "direction$", "map", "y", "bufferCount", "a", "b", "distinctUntilChanged", "active$", "active", "combineLatest", "direction", "takeUntil", "skip", "endWith", "repeat", "hidden", "mountBackToTop", "el", "header$", "push$", "Subject", "done$", "takeLast", "distinctUntilKeyChanged", "height", "tap", "state", "finalize", "__spreadValues", "patchIndeterminate", "document$", "tablet$", "switchMap", "getElements", "tap", "el", "mergeMap", "fromEvent", "takeWhile", "map", "withLatestFrom", "tablet", "isAppleDevice", "patchScrollfix", "document$", "switchMap", "getElements", "tap", "el", "filter", "mergeMap", "fromEvent", "map", "top", "patchScrolllock", "viewport$", "tablet$", "combineLatest", "watchToggle", "map", "active", "tablet", "switchMap", "of", "delay", "withLatestFrom", "y", "value", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "document$", "watchDocument", "location$", "watchLocation", "target$", "watchLocationTarget", "keyboard$", "watchKeyboard", "viewport$", "watchViewport", "tablet$", "watchMedia", "screen$", "print$", "watchPrint", "config", "configuration", "index$", "requestJSON", "NEVER", "alert$", "Subject", "setupClipboardJS", "feature", "setupInstantLoading", "_a", "setupVersionSelector", "merge", "delay", "setToggle", "filter", "mode", "key", "prev", "getOptionalElement", "next", "patchIndeterminate", "patchScrollfix", "patchScrolllock", "header$", "watchHeader", "getComponentElement", "main$", "map", "switchMap", "el", "watchMain", "shareReplay", "control$", "getComponentElements", "mountConsent", "mountDialog", "mountHeader", "mountPalette", "mountSearch", "mountSource", "content$", "defer", "mountAnnounce", "mountContent", "mountSearchHiglight", "EMPTY", "mountHeaderTitle", "at", "mountSidebar", "mountTabs", "mountTableOfContents", "mountBackToTop", "component$", "mergeWith"] +} diff --git a/assets/javascripts/lunr/min/lunr.ar.min.js b/assets/javascripts/lunr/min/lunr.ar.min.js new file mode 100644 index 00000000..248ddc5d --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ar.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ar=function(){this.pipeline.reset(),this.pipeline.add(e.ar.trimmer,e.ar.stopWordFilter,e.ar.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ar.stemmer))},e.ar.wordCharacters="ء-ٛٱـ",e.ar.trimmer=e.trimmerSupport.generateTrimmer(e.ar.wordCharacters),e.Pipeline.registerFunction(e.ar.trimmer,"trimmer-ar"),e.ar.stemmer=function(){var e=this;return e.result=!1,e.preRemoved=!1,e.sufRemoved=!1,e.pre={pre1:"ف ك ب و س ل ن ا ي ت",pre2:"ال لل",pre3:"بال وال فال تال كال ولل",pre4:"فبال كبال وبال وكال"},e.suf={suf1:"ه ك ت ن ا ي",suf2:"نك نه ها وك يا اه ون ين تن تم نا وا ان كم كن ني نن ما هم هن تك ته ات يه",suf3:"تين كهم نيه نهم ونه وها يهم ونا ونك وني وهم تكم تنا تها تني تهم كما كها ناه نكم هنا تان يها",suf4:"كموه ناها ونني ونهم تكما تموه تكاه كماه ناكم ناهم نيها وننا"},e.patterns=JSON.parse('{"pt43":[{"pt":[{"c":"ا","l":1}]},{"pt":[{"c":"ا,ت,ن,ي","l":0}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"و","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ل","l":2,"m":3}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ي","l":2}],"mPt":[{"c":"ف","l":0,"m":0},{"c":"ع","l":1,"m":1},{"c":"ا","l":2},{"c":"ل","l":3,"m":3}]},{"pt":[{"c":"م","l":0}]}],"pt53":[{"pt":[{"c":"ت","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":3},{"c":"ل","l":3,"m":4},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":0},{"c":"ا","l":3}],"mPt":[{"c":"ف","l":0,"m":1},{"c":"ع","l":1,"m":2},{"c":"ل","l":2,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ن","l":4}]},{"pt":[{"c":"ت","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"م","l":0},{"c":"و","l":3}]},{"pt":[{"c":"ا","l":1},{"c":"و","l":3}]},{"pt":[{"c":"و","l":1},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ي","l":3}]},{"pt":[{"c":"ا","l":2},{"c":"ن","l":3}]},{"pt":[{"c":"م","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"م","l":0},{"c":"ا","l":2}]},{"pt":[{"c":"م","l":1},{"c":"ا","l":3}]},{"pt":[{"c":"ي,ت,ا,ن","l":0},{"c":"ت","l":1}],"mPt":[{"c":"ف","l":0,"m":2},{"c":"ع","l":1,"m":3},{"c":"ا","l":2},{"c":"ل","l":3,"m":4}]},{"pt":[{"c":"ت,ي,ا,ن","l":0},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ت","l":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":2},{"c":"ي","l":3}]},{"pt":[{"c":"ا,ي,ت,ن","l":0},{"c":"ن","l":1}],"mPt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ف","l":2,"m":2},{"c":"ع","l":3,"m":3},{"c":"ا","l":4},{"c":"ل","l":5,"m":4}]},{"pt":[{"c":"ا","l":3},{"c":"ء","l":4}]}],"pt63":[{"pt":[{"c":"ا","l":0},{"c":"ت","l":2},{"c":"ا","l":4}]},{"pt":[{"c":"ا,ت,ن,ي","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ا,ن,ت,ي","l":0},{"c":"و","l":3}]},{"pt":[{"c":"م","l":0},{"c":"س","l":1},{"c":"ت","l":2}],"mPt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ف","l":3,"m":3},{"c":"ع","l":4,"m":4},{"c":"ا","l":5},{"c":"ل","l":6,"m":5}]},{"pt":[{"c":"ي","l":1},{"c":"ي","l":3},{"c":"ا","l":4},{"c":"ء","l":5}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":1},{"c":"ا","l":4}]}],"pt54":[{"pt":[{"c":"ت","l":0}]},{"pt":[{"c":"ا,ي,ت,ن","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"م","l":0}],"mPt":[{"c":"ا","l":0},{"c":"ف","l":1,"m":1},{"c":"ع","l":2,"m":2},{"c":"ل","l":3,"m":3},{"c":"ر","l":4,"m":4},{"c":"ا","l":5},{"c":"ر","l":6,"m":4}]},{"pt":[{"c":"ا","l":2}]},{"pt":[{"c":"ا","l":0},{"c":"ن","l":2}]}],"pt64":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":4}]},{"pt":[{"c":"م","l":0},{"c":"ت","l":1}]}],"pt73":[{"pt":[{"c":"ا","l":0},{"c":"س","l":1},{"c":"ت","l":2},{"c":"ا","l":5}]}],"pt75":[{"pt":[{"c":"ا","l":0},{"c":"ا","l":5}]}]}'),e.execArray=["cleanWord","removeDiacritics","cleanAlef","removeStopWords","normalizeHamzaAndAlef","removeStartWaw","removePre432","removeEndTaa","wordCheck"],e.stem=function(){var r=0;for(e.result=!1,e.preRemoved=!1,e.sufRemoved=!1;r=0)return!0},e.normalizeHamzaAndAlef=function(){return e.word=e.word.replace("ؤ","ء"),e.word=e.word.replace("ئ","ء"),e.word=e.word.replace(/([\u0627])\1+/gi,"ا"),!1},e.removeEndTaa=function(){return!(e.word.length>2)||(e.word=e.word.replace(/[\u0627]$/,""),e.word=e.word.replace("ة",""),!1)},e.removeStartWaw=function(){return e.word.length>3&&"و"==e.word[0]&&"و"==e.word[1]&&(e.word=e.word.slice(1)),!1},e.removePre432=function(){var r=e.word;if(e.word.length>=7){var t=new RegExp("^("+e.pre.pre4.split(" ").join("|")+")");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=6){var c=new RegExp("^("+e.pre.pre3.split(" ").join("|")+")");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=5){var l=new RegExp("^("+e.pre.pre2.split(" ").join("|")+")");e.word=e.word.replace(l,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.patternCheck=function(r){for(var t=0;t3){var t=new RegExp("^("+e.pre.pre1.split(" ").join("|")+")");e.word=e.word.replace(t,"")}return r!=e.word&&(e.preRemoved=!0),!1},e.removeSuf1=function(){var r=e.word;if(0==e.sufRemoved&&e.word.length>3){var t=new RegExp("("+e.suf.suf1.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.removeSuf432=function(){var r=e.word;if(e.word.length>=6){var t=new RegExp("("+e.suf.suf4.split(" ").join("|")+")$");e.word=e.word.replace(t,"")}if(e.word==r&&e.word.length>=5){var c=new RegExp("("+e.suf.suf3.split(" ").join("|")+")$");e.word=e.word.replace(c,"")}if(e.word==r&&e.word.length>=4){var l=new RegExp("("+e.suf.suf2.split(" ").join("|")+")$");e.word=e.word.replace(l,"")}return r!=e.word&&(e.sufRemoved=!0),!1},e.wordCheck=function(){for(var r=(e.word,[e.removeSuf432,e.removeSuf1,e.removePre1]),t=0,c=!1;e.word.length>=7&&!e.result&&t=f.limit)return;f.cursor++}for(;!f.out_grouping(w,97,248);){if(f.cursor>=f.limit)return;f.cursor++}d=f.cursor,d=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(c,32),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del();break;case 2:f.in_grouping_b(p,97,229)&&f.slice_del()}}function t(){var e,r=f.limit-f.cursor;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.find_among_b(l,4)?(f.bra=f.cursor,f.limit_backward=e,f.cursor=f.limit-r,f.cursor>f.limit_backward&&(f.cursor--,f.bra=f.cursor,f.slice_del())):f.limit_backward=e)}function s(){var e,r,i,n=f.limit-f.cursor;if(f.ket=f.cursor,f.eq_s_b(2,"st")&&(f.bra=f.cursor,f.eq_s_b(2,"ig")&&f.slice_del()),f.cursor=f.limit-n,f.cursor>=d&&(r=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,e=f.find_among_b(m,5),f.limit_backward=r,e))switch(f.bra=f.cursor,e){case 1:f.slice_del(),i=f.limit-f.cursor,t(),f.cursor=f.limit-i;break;case 2:f.slice_from("løs")}}function o(){var e;f.cursor>=d&&(e=f.limit_backward,f.limit_backward=d,f.ket=f.cursor,f.out_grouping_b(w,97,248)?(f.bra=f.cursor,u=f.slice_to(u),f.limit_backward=e,f.eq_v_b(u)&&f.slice_del()):f.limit_backward=e)}var a,d,u,c=[new r("hed",-1,1),new r("ethed",0,1),new r("ered",-1,1),new r("e",-1,1),new r("erede",3,1),new r("ende",3,1),new r("erende",5,1),new r("ene",3,1),new r("erne",3,1),new r("ere",3,1),new r("en",-1,1),new r("heden",10,1),new r("eren",10,1),new r("er",-1,1),new r("heder",13,1),new r("erer",13,1),new r("s",-1,2),new r("heds",16,1),new r("es",16,1),new r("endes",18,1),new r("erendes",19,1),new r("enes",18,1),new r("ernes",18,1),new r("eres",18,1),new r("ens",16,1),new r("hedens",24,1),new r("erens",24,1),new r("ers",16,1),new r("ets",16,1),new r("erets",28,1),new r("et",-1,1),new r("eret",30,1)],l=[new r("gd",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("elig",1,1),new r("els",-1,1),new r("løst",-1,2)],w=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],p=[239,254,42,3,0,0,0,0,0,0,0,0,0,0,0,0,16],f=new i;this.setCurrent=function(e){f.setCurrent(e)},this.getCurrent=function(){return f.getCurrent()},this.stem=function(){var r=f.cursor;return e(),f.limit_backward=r,f.cursor=f.limit,n(),f.cursor=f.limit,t(),f.cursor=f.limit,s(),f.cursor=f.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.da.stemmer,"stemmer-da"),e.da.stopWordFilter=e.generateStopWordFilter("ad af alle alt anden at blev blive bliver da de dem den denne der deres det dette dig din disse dog du efter eller en end er et for fra ham han hans har havde have hende hendes her hos hun hvad hvis hvor i ikke ind jeg jer jo kunne man mange med meget men mig min mine mit mod ned noget nogle nu når og også om op os over på selv sig sin sine sit skal skulle som sådan thi til ud under var vi vil ville vor være været".split(" ")),e.Pipeline.registerFunction(e.da.stopWordFilter,"stopWordFilter-da")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.de.min.js b/assets/javascripts/lunr/min/lunr.de.min.js new file mode 100644 index 00000000..f3b5c108 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.de.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `German` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.de=function(){this.pipeline.reset(),this.pipeline.add(e.de.trimmer,e.de.stopWordFilter,e.de.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.de.stemmer))},e.de.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.de.trimmer=e.trimmerSupport.generateTrimmer(e.de.wordCharacters),e.Pipeline.registerFunction(e.de.trimmer,"trimmer-de"),e.de.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!v.eq_s(1,e)||(v.ket=v.cursor,!v.in_grouping(p,97,252)))&&(v.slice_from(r),v.cursor=n,!0)}function i(){for(var r,n,i,s,t=v.cursor;;)if(r=v.cursor,v.bra=r,v.eq_s(1,"ß"))v.ket=v.cursor,v.slice_from("ss");else{if(r>=v.limit)break;v.cursor=r+1}for(v.cursor=t;;)for(n=v.cursor;;){if(i=v.cursor,v.in_grouping(p,97,252)){if(s=v.cursor,v.bra=s,e("u","U",i))break;if(v.cursor=s,e("y","Y",i))break}if(i>=v.limit)return void(v.cursor=n);v.cursor=i+1}}function s(){for(;!v.in_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}for(;!v.out_grouping(p,97,252);){if(v.cursor>=v.limit)return!0;v.cursor++}return!1}function t(){m=v.limit,l=m;var e=v.cursor+3;0<=e&&e<=v.limit&&(d=e,s()||(m=v.cursor,m=v.limit)return;v.cursor++}}}function c(){return m<=v.cursor}function u(){return l<=v.cursor}function a(){var e,r,n,i,s=v.limit-v.cursor;if(v.ket=v.cursor,(e=v.find_among_b(w,7))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:v.slice_del(),v.ket=v.cursor,v.eq_s_b(1,"s")&&(v.bra=v.cursor,v.eq_s_b(3,"nis")&&v.slice_del());break;case 3:v.in_grouping_b(g,98,116)&&v.slice_del()}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(f,4))&&(v.bra=v.cursor,c()))switch(e){case 1:v.slice_del();break;case 2:if(v.in_grouping_b(k,98,116)){var t=v.cursor-3;v.limit_backward<=t&&t<=v.limit&&(v.cursor=t,v.slice_del())}}if(v.cursor=v.limit-s,v.ket=v.cursor,(e=v.find_among_b(_,8))&&(v.bra=v.cursor,u()))switch(e){case 1:v.slice_del(),v.ket=v.cursor,v.eq_s_b(2,"ig")&&(v.bra=v.cursor,r=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-r,u()&&v.slice_del()));break;case 2:n=v.limit-v.cursor,v.eq_s_b(1,"e")||(v.cursor=v.limit-n,v.slice_del());break;case 3:if(v.slice_del(),v.ket=v.cursor,i=v.limit-v.cursor,!v.eq_s_b(2,"er")&&(v.cursor=v.limit-i,!v.eq_s_b(2,"en")))break;v.bra=v.cursor,c()&&v.slice_del();break;case 4:v.slice_del(),v.ket=v.cursor,e=v.find_among_b(b,2),e&&(v.bra=v.cursor,u()&&1==e&&v.slice_del())}}var d,l,m,h=[new r("",-1,6),new r("U",0,2),new r("Y",0,1),new r("ä",0,3),new r("ö",0,4),new r("ü",0,5)],w=[new r("e",-1,2),new r("em",-1,1),new r("en",-1,2),new r("ern",-1,1),new r("er",-1,1),new r("s",-1,3),new r("es",5,2)],f=[new r("en",-1,1),new r("er",-1,1),new r("st",-1,2),new r("est",2,1)],b=[new r("ig",-1,1),new r("lich",-1,1)],_=[new r("end",-1,1),new r("ig",-1,2),new r("ung",-1,1),new r("lich",-1,3),new r("isch",-1,2),new r("ik",-1,2),new r("heit",-1,3),new r("keit",-1,4)],p=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32,8],g=[117,30,5],k=[117,30,4],v=new n;this.setCurrent=function(e){v.setCurrent(e)},this.getCurrent=function(){return v.getCurrent()},this.stem=function(){var e=v.cursor;return i(),v.cursor=e,t(),v.limit_backward=e,v.cursor=v.limit,a(),v.cursor=v.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.de.stemmer,"stemmer-de"),e.de.stopWordFilter=e.generateStopWordFilter("aber alle allem allen aller alles als also am an ander andere anderem anderen anderer anderes anderm andern anderr anders auch auf aus bei bin bis bist da damit dann das dasselbe dazu daß dein deine deinem deinen deiner deines dem demselben den denn denselben der derer derselbe derselben des desselben dessen dich die dies diese dieselbe dieselben diesem diesen dieser dieses dir doch dort du durch ein eine einem einen einer eines einig einige einigem einigen einiger einiges einmal er es etwas euch euer eure eurem euren eurer eures für gegen gewesen hab habe haben hat hatte hatten hier hin hinter ich ihm ihn ihnen ihr ihre ihrem ihren ihrer ihres im in indem ins ist jede jedem jeden jeder jedes jene jenem jenen jener jenes jetzt kann kein keine keinem keinen keiner keines können könnte machen man manche manchem manchen mancher manches mein meine meinem meinen meiner meines mich mir mit muss musste nach nicht nichts noch nun nur ob oder ohne sehr sein seine seinem seinen seiner seines selbst sich sie sind so solche solchem solchen solcher solches soll sollte sondern sonst um und uns unse unsem unsen unser unses unter viel vom von vor war waren warst was weg weil weiter welche welchem welchen welcher welches wenn werde werden wie wieder will wir wird wirst wo wollen wollte während würde würden zu zum zur zwar zwischen über".split(" ")),e.Pipeline.registerFunction(e.de.stopWordFilter,"stopWordFilter-de")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.du.min.js b/assets/javascripts/lunr/min/lunr.du.min.js new file mode 100644 index 00000000..49a0f3f0 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.du.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Dutch` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");console.warn('[Lunr Languages] Please use the "nl" instead of the "du". The "nl" code is the standard code for Dutch language, and "du" will be removed in the next major versions.'),e.du=function(){this.pipeline.reset(),this.pipeline.add(e.du.trimmer,e.du.stopWordFilter,e.du.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.du.stemmer))},e.du.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.du.trimmer=e.trimmerSupport.generateTrimmer(e.du.wordCharacters),e.Pipeline.registerFunction(e.du.trimmer,"trimmer-du"),e.du.stemmer=function(){var r=e.stemmerSupport.Among,i=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e,r,i,o=C.cursor;;){if(C.bra=C.cursor,e=C.find_among(b,11))switch(C.ket=C.cursor,e){case 1:C.slice_from("a");continue;case 2:C.slice_from("e");continue;case 3:C.slice_from("i");continue;case 4:C.slice_from("o");continue;case 5:C.slice_from("u");continue;case 6:if(C.cursor>=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(r=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=r);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=r;else if(n(r))break}else if(n(r))break}function n(e){return C.cursor=e,e>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,f=_,t()||(_=C.cursor,_<3&&(_=3),t()||(f=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var e;;)if(C.bra=C.cursor,e=C.find_among(p,3))switch(C.ket=C.cursor,e){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return f<=C.cursor}function a(){var e=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-e,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var e;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.slice_del(),w=!0,a())))}function m(){var e;u()&&(e=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-e,C.eq_s_b(3,"gem")||(C.cursor=C.limit-e,C.slice_del(),a())))}function d(){var e,r,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,e=C.find_among_b(h,5))switch(C.bra=C.cursor,e){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(z,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(r=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-r,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,e=C.find_among_b(k,6))switch(C.bra=C.cursor,e){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(j,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var f,_,w,b=[new r("",-1,6),new r("á",0,1),new r("ä",0,1),new r("é",0,2),new r("ë",0,2),new r("í",0,3),new r("ï",0,3),new r("ó",0,4),new r("ö",0,4),new r("ú",0,5),new r("ü",0,5)],p=[new r("",-1,3),new r("I",0,2),new r("Y",0,1)],g=[new r("dd",-1,-1),new r("kk",-1,-1),new r("tt",-1,-1)],h=[new r("ene",-1,2),new r("se",-1,3),new r("en",-1,2),new r("heden",2,1),new r("s",-1,3)],k=[new r("end",-1,1),new r("ig",-1,2),new r("ing",-1,1),new r("lijk",-1,3),new r("baar",-1,4),new r("bar",-1,5)],v=[new r("aa",-1,-1),new r("ee",-1,-1),new r("oo",-1,-1),new r("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(e){C.setCurrent(e)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var r=C.cursor;return e(),C.cursor=r,o(),C.limit_backward=r,C.cursor=C.limit,d(),C.cursor=C.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.du.stemmer,"stemmer-du"),e.du.stopWordFilter=e.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),e.Pipeline.registerFunction(e.du.stopWordFilter,"stopWordFilter-du")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.es.min.js b/assets/javascripts/lunr/min/lunr.es.min.js new file mode 100644 index 00000000..2989d342 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.es.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Spanish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,s){"function"==typeof define&&define.amd?define(s):"object"==typeof exports?module.exports=s():s()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.es=function(){this.pipeline.reset(),this.pipeline.add(e.es.trimmer,e.es.stopWordFilter,e.es.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.es.stemmer))},e.es.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.es.trimmer=e.trimmerSupport.generateTrimmer(e.es.wordCharacters),e.Pipeline.registerFunction(e.es.trimmer,"trimmer-es"),e.es.stemmer=function(){var s=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(){if(A.out_grouping(x,97,252)){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}return!0}function n(){if(A.in_grouping(x,97,252)){var s=A.cursor;if(e()){if(A.cursor=s,!A.in_grouping(x,97,252))return!0;for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!0;A.cursor++}}return!1}return!0}function i(){var s,r=A.cursor;if(n()){if(A.cursor=r,!A.out_grouping(x,97,252))return;if(s=A.cursor,e()){if(A.cursor=s,!A.in_grouping(x,97,252)||A.cursor>=A.limit)return;A.cursor++}}g=A.cursor}function a(){for(;!A.in_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}for(;!A.out_grouping(x,97,252);){if(A.cursor>=A.limit)return!1;A.cursor++}return!0}function t(){var e=A.cursor;g=A.limit,p=g,v=g,i(),A.cursor=e,a()&&(p=A.cursor,a()&&(v=A.cursor))}function o(){for(var e;;){if(A.bra=A.cursor,e=A.find_among(k,6))switch(A.ket=A.cursor,e){case 1:A.slice_from("a");continue;case 2:A.slice_from("e");continue;case 3:A.slice_from("i");continue;case 4:A.slice_from("o");continue;case 5:A.slice_from("u");continue;case 6:if(A.cursor>=A.limit)break;A.cursor++;continue}break}}function u(){return g<=A.cursor}function w(){return p<=A.cursor}function c(){return v<=A.cursor}function m(){var e;if(A.ket=A.cursor,A.find_among_b(y,13)&&(A.bra=A.cursor,(e=A.find_among_b(q,11))&&u()))switch(e){case 1:A.bra=A.cursor,A.slice_from("iendo");break;case 2:A.bra=A.cursor,A.slice_from("ando");break;case 3:A.bra=A.cursor,A.slice_from("ar");break;case 4:A.bra=A.cursor,A.slice_from("er");break;case 5:A.bra=A.cursor,A.slice_from("ir");break;case 6:A.slice_del();break;case 7:A.eq_s_b(1,"u")&&A.slice_del()}}function l(e,s){if(!c())return!0;A.slice_del(),A.ket=A.cursor;var r=A.find_among_b(e,s);return r&&(A.bra=A.cursor,1==r&&c()&&A.slice_del()),!1}function d(e){return!c()||(A.slice_del(),A.ket=A.cursor,A.eq_s_b(2,e)&&(A.bra=A.cursor,c()&&A.slice_del()),!1)}function b(){var e;if(A.ket=A.cursor,e=A.find_among_b(S,46)){switch(A.bra=A.cursor,e){case 1:if(!c())return!1;A.slice_del();break;case 2:if(d("ic"))return!1;break;case 3:if(!c())return!1;A.slice_from("log");break;case 4:if(!c())return!1;A.slice_from("u");break;case 5:if(!c())return!1;A.slice_from("ente");break;case 6:if(!w())return!1;A.slice_del(),A.ket=A.cursor,e=A.find_among_b(C,4),e&&(A.bra=A.cursor,c()&&(A.slice_del(),1==e&&(A.ket=A.cursor,A.eq_s_b(2,"at")&&(A.bra=A.cursor,c()&&A.slice_del()))));break;case 7:if(l(P,3))return!1;break;case 8:if(l(F,3))return!1;break;case 9:if(d("at"))return!1}return!0}return!1}function f(){var e,s;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(W,12),A.limit_backward=s,e)){if(A.bra=A.cursor,1==e){if(!A.eq_s_b(1,"u"))return!1;A.slice_del()}return!0}return!1}function _(){var e,s,r,n;if(A.cursor>=g&&(s=A.limit_backward,A.limit_backward=g,A.ket=A.cursor,e=A.find_among_b(L,96),A.limit_backward=s,e))switch(A.bra=A.cursor,e){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"u")?(n=A.limit-A.cursor,A.eq_s_b(1,"g")?A.cursor=A.limit-n:A.cursor=A.limit-r):A.cursor=A.limit-r,A.bra=A.cursor;case 2:A.slice_del()}}function h(){var e,s;if(A.ket=A.cursor,e=A.find_among_b(z,8))switch(A.bra=A.cursor,e){case 1:u()&&A.slice_del();break;case 2:u()&&(A.slice_del(),A.ket=A.cursor,A.eq_s_b(1,"u")&&(A.bra=A.cursor,s=A.limit-A.cursor,A.eq_s_b(1,"g")&&(A.cursor=A.limit-s,u()&&A.slice_del())))}}var v,p,g,k=[new s("",-1,6),new s("á",0,1),new s("é",0,2),new s("í",0,3),new s("ó",0,4),new s("ú",0,5)],y=[new s("la",-1,-1),new s("sela",0,-1),new s("le",-1,-1),new s("me",-1,-1),new s("se",-1,-1),new s("lo",-1,-1),new s("selo",5,-1),new s("las",-1,-1),new s("selas",7,-1),new s("les",-1,-1),new s("los",-1,-1),new s("selos",10,-1),new s("nos",-1,-1)],q=[new s("ando",-1,6),new s("iendo",-1,6),new s("yendo",-1,7),new s("ándo",-1,2),new s("iéndo",-1,1),new s("ar",-1,6),new s("er",-1,6),new s("ir",-1,6),new s("ár",-1,3),new s("ér",-1,4),new s("ír",-1,5)],C=[new s("ic",-1,-1),new s("ad",-1,-1),new s("os",-1,-1),new s("iv",-1,1)],P=[new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,1)],F=[new s("ic",-1,1),new s("abil",-1,1),new s("iv",-1,1)],S=[new s("ica",-1,1),new s("ancia",-1,2),new s("encia",-1,5),new s("adora",-1,2),new s("osa",-1,1),new s("ista",-1,1),new s("iva",-1,9),new s("anza",-1,1),new s("logía",-1,3),new s("idad",-1,8),new s("able",-1,1),new s("ible",-1,1),new s("ante",-1,2),new s("mente",-1,7),new s("amente",13,6),new s("ación",-1,2),new s("ución",-1,4),new s("ico",-1,1),new s("ismo",-1,1),new s("oso",-1,1),new s("amiento",-1,1),new s("imiento",-1,1),new s("ivo",-1,9),new s("ador",-1,2),new s("icas",-1,1),new s("ancias",-1,2),new s("encias",-1,5),new s("adoras",-1,2),new s("osas",-1,1),new s("istas",-1,1),new s("ivas",-1,9),new s("anzas",-1,1),new s("logías",-1,3),new s("idades",-1,8),new s("ables",-1,1),new s("ibles",-1,1),new s("aciones",-1,2),new s("uciones",-1,4),new s("adores",-1,2),new s("antes",-1,2),new s("icos",-1,1),new s("ismos",-1,1),new s("osos",-1,1),new s("amientos",-1,1),new s("imientos",-1,1),new s("ivos",-1,9)],W=[new s("ya",-1,1),new s("ye",-1,1),new s("yan",-1,1),new s("yen",-1,1),new s("yeron",-1,1),new s("yendo",-1,1),new s("yo",-1,1),new s("yas",-1,1),new s("yes",-1,1),new s("yais",-1,1),new s("yamos",-1,1),new s("yó",-1,1)],L=[new s("aba",-1,2),new s("ada",-1,2),new s("ida",-1,2),new s("ara",-1,2),new s("iera",-1,2),new s("ía",-1,2),new s("aría",5,2),new s("ería",5,2),new s("iría",5,2),new s("ad",-1,2),new s("ed",-1,2),new s("id",-1,2),new s("ase",-1,2),new s("iese",-1,2),new s("aste",-1,2),new s("iste",-1,2),new s("an",-1,2),new s("aban",16,2),new s("aran",16,2),new s("ieran",16,2),new s("ían",16,2),new s("arían",20,2),new s("erían",20,2),new s("irían",20,2),new s("en",-1,1),new s("asen",24,2),new s("iesen",24,2),new s("aron",-1,2),new s("ieron",-1,2),new s("arán",-1,2),new s("erán",-1,2),new s("irán",-1,2),new s("ado",-1,2),new s("ido",-1,2),new s("ando",-1,2),new s("iendo",-1,2),new s("ar",-1,2),new s("er",-1,2),new s("ir",-1,2),new s("as",-1,2),new s("abas",39,2),new s("adas",39,2),new s("idas",39,2),new s("aras",39,2),new s("ieras",39,2),new s("ías",39,2),new s("arías",45,2),new s("erías",45,2),new s("irías",45,2),new s("es",-1,1),new s("ases",49,2),new s("ieses",49,2),new s("abais",-1,2),new s("arais",-1,2),new s("ierais",-1,2),new s("íais",-1,2),new s("aríais",55,2),new s("eríais",55,2),new s("iríais",55,2),new s("aseis",-1,2),new s("ieseis",-1,2),new s("asteis",-1,2),new s("isteis",-1,2),new s("áis",-1,2),new s("éis",-1,1),new s("aréis",64,2),new s("eréis",64,2),new s("iréis",64,2),new s("ados",-1,2),new s("idos",-1,2),new s("amos",-1,2),new s("ábamos",70,2),new s("áramos",70,2),new s("iéramos",70,2),new s("íamos",70,2),new s("aríamos",74,2),new s("eríamos",74,2),new s("iríamos",74,2),new s("emos",-1,1),new s("aremos",78,2),new s("eremos",78,2),new s("iremos",78,2),new s("ásemos",78,2),new s("iésemos",78,2),new s("imos",-1,2),new s("arás",-1,2),new s("erás",-1,2),new s("irás",-1,2),new s("ís",-1,2),new s("ará",-1,2),new s("erá",-1,2),new s("irá",-1,2),new s("aré",-1,2),new s("eré",-1,2),new s("iré",-1,2),new s("ió",-1,2)],z=[new s("a",-1,1),new s("e",-1,2),new s("o",-1,1),new s("os",-1,1),new s("á",-1,1),new s("é",-1,2),new s("í",-1,1),new s("ó",-1,1)],x=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,4,10],A=new r;this.setCurrent=function(e){A.setCurrent(e)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return t(),A.limit_backward=e,A.cursor=A.limit,m(),A.cursor=A.limit,b()||(A.cursor=A.limit,f()||(A.cursor=A.limit,_())),A.cursor=A.limit,h(),A.cursor=A.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.es.stemmer,"stemmer-es"),e.es.stopWordFilter=e.generateStopWordFilter("a al algo algunas algunos ante antes como con contra cual cuando de del desde donde durante e el ella ellas ellos en entre era erais eran eras eres es esa esas ese eso esos esta estaba estabais estaban estabas estad estada estadas estado estados estamos estando estar estaremos estará estarán estarás estaré estaréis estaría estaríais estaríamos estarían estarías estas este estemos esto estos estoy estuve estuviera estuvierais estuvieran estuvieras estuvieron estuviese estuvieseis estuviesen estuvieses estuvimos estuviste estuvisteis estuviéramos estuviésemos estuvo está estábamos estáis están estás esté estéis estén estés fue fuera fuerais fueran fueras fueron fuese fueseis fuesen fueses fui fuimos fuiste fuisteis fuéramos fuésemos ha habida habidas habido habidos habiendo habremos habrá habrán habrás habré habréis habría habríais habríamos habrían habrías habéis había habíais habíamos habían habías han has hasta hay haya hayamos hayan hayas hayáis he hemos hube hubiera hubierais hubieran hubieras hubieron hubiese hubieseis hubiesen hubieses hubimos hubiste hubisteis hubiéramos hubiésemos hubo la las le les lo los me mi mis mucho muchos muy más mí mía mías mío míos nada ni no nos nosotras nosotros nuestra nuestras nuestro nuestros o os otra otras otro otros para pero poco por porque que quien quienes qué se sea seamos sean seas seremos será serán serás seré seréis sería seríais seríamos serían serías seáis sido siendo sin sobre sois somos son soy su sus suya suyas suyo suyos sí también tanto te tendremos tendrá tendrán tendrás tendré tendréis tendría tendríais tendríamos tendrían tendrías tened tenemos tenga tengamos tengan tengas tengo tengáis tenida tenidas tenido tenidos teniendo tenéis tenía teníais teníamos tenían tenías ti tiene tienen tienes todo todos tu tus tuve tuviera tuvierais tuvieran tuvieras tuvieron tuviese tuvieseis tuviesen tuvieses tuvimos tuviste tuvisteis tuviéramos tuviésemos tuvo tuya tuyas tuyo tuyos tú un una uno unos vosotras vosotros vuestra vuestras vuestro vuestros y ya yo él éramos".split(" ")),e.Pipeline.registerFunction(e.es.stopWordFilter,"stopWordFilter-es")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.fi.min.js b/assets/javascripts/lunr/min/lunr.fi.min.js new file mode 100644 index 00000000..29f5dfce --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.fi.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Finnish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(i,e){"function"==typeof define&&define.amd?define(e):"object"==typeof exports?module.exports=e():e()(i.lunr)}(this,function(){return function(i){if(void 0===i)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===i.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");i.fi=function(){this.pipeline.reset(),this.pipeline.add(i.fi.trimmer,i.fi.stopWordFilter,i.fi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(i.fi.stemmer))},i.fi.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",i.fi.trimmer=i.trimmerSupport.generateTrimmer(i.fi.wordCharacters),i.Pipeline.registerFunction(i.fi.trimmer,"trimmer-fi"),i.fi.stemmer=function(){var e=i.stemmerSupport.Among,r=i.stemmerSupport.SnowballProgram,n=new function(){function i(){f=A.limit,d=f,n()||(f=A.cursor,n()||(d=A.cursor))}function n(){for(var i;;){if(i=A.cursor,A.in_grouping(W,97,246))break;if(A.cursor=i,i>=A.limit)return!0;A.cursor++}for(A.cursor=i;!A.out_grouping(W,97,246);){if(A.cursor>=A.limit)return!0;A.cursor++}return!1}function t(){return d<=A.cursor}function s(){var i,e;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(h,10)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.in_grouping_b(x,97,246))return;break;case 2:if(!t())return}A.slice_del()}else A.limit_backward=e}function o(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(v,9))switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:r=A.limit-A.cursor,A.eq_s_b(1,"k")||(A.cursor=A.limit-r,A.slice_del());break;case 2:A.slice_del(),A.ket=A.cursor,A.eq_s_b(3,"kse")&&(A.bra=A.cursor,A.slice_from("ksi"));break;case 3:A.slice_del();break;case 4:A.find_among_b(p,6)&&A.slice_del();break;case 5:A.find_among_b(g,6)&&A.slice_del();break;case 6:A.find_among_b(j,2)&&A.slice_del()}else A.limit_backward=e}function l(){return A.find_among_b(q,7)}function a(){return A.eq_s_b(1,"i")&&A.in_grouping_b(L,97,246)}function u(){var i,e,r;if(A.cursor>=f)if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,i=A.find_among_b(C,30)){switch(A.bra=A.cursor,A.limit_backward=e,i){case 1:if(!A.eq_s_b(1,"a"))return;break;case 2:case 9:if(!A.eq_s_b(1,"e"))return;break;case 3:if(!A.eq_s_b(1,"i"))return;break;case 4:if(!A.eq_s_b(1,"o"))return;break;case 5:if(!A.eq_s_b(1,"ä"))return;break;case 6:if(!A.eq_s_b(1,"ö"))return;break;case 7:if(r=A.limit-A.cursor,!l()&&(A.cursor=A.limit-r,!A.eq_s_b(2,"ie"))){A.cursor=A.limit-r;break}if(A.cursor=A.limit-r,A.cursor<=A.limit_backward){A.cursor=A.limit-r;break}A.cursor--,A.bra=A.cursor;break;case 8:if(!A.in_grouping_b(W,97,246)||!A.out_grouping_b(W,97,246))return}A.slice_del(),k=!0}else A.limit_backward=e}function c(){var i,e,r;if(A.cursor>=d)if(e=A.limit_backward,A.limit_backward=d,A.ket=A.cursor,i=A.find_among_b(P,14)){if(A.bra=A.cursor,A.limit_backward=e,1==i){if(r=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-r}A.slice_del()}else A.limit_backward=e}function m(){var i;A.cursor>=f&&(i=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.find_among_b(F,2)?(A.bra=A.cursor,A.limit_backward=i,A.slice_del()):A.limit_backward=i)}function w(){var i,e,r,n,t,s;if(A.cursor>=f){if(e=A.limit_backward,A.limit_backward=f,A.ket=A.cursor,A.eq_s_b(1,"t")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.in_grouping_b(W,97,246)&&(A.cursor=A.limit-r,A.slice_del(),A.limit_backward=e,n=A.limit-A.cursor,A.cursor>=d&&(A.cursor=d,t=A.limit_backward,A.limit_backward=A.cursor,A.cursor=A.limit-n,A.ket=A.cursor,i=A.find_among_b(S,2))))){if(A.bra=A.cursor,A.limit_backward=t,1==i){if(s=A.limit-A.cursor,A.eq_s_b(2,"po"))return;A.cursor=A.limit-s}return void A.slice_del()}A.limit_backward=e}}function _(){var i,e,r,n;if(A.cursor>=f){for(i=A.limit_backward,A.limit_backward=f,e=A.limit-A.cursor,l()&&(A.cursor=A.limit-e,A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.in_grouping_b(y,97,228)&&(A.bra=A.cursor,A.out_grouping_b(W,97,246)&&A.slice_del()),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"j")&&(A.bra=A.cursor,r=A.limit-A.cursor,A.eq_s_b(1,"o")?A.slice_del():(A.cursor=A.limit-r,A.eq_s_b(1,"u")&&A.slice_del())),A.cursor=A.limit-e,A.ket=A.cursor,A.eq_s_b(1,"o")&&(A.bra=A.cursor,A.eq_s_b(1,"j")&&A.slice_del()),A.cursor=A.limit-e,A.limit_backward=i;;){if(n=A.limit-A.cursor,A.out_grouping_b(W,97,246)){A.cursor=A.limit-n;break}if(A.cursor=A.limit-n,A.cursor<=A.limit_backward)return;A.cursor--}A.ket=A.cursor,A.cursor>A.limit_backward&&(A.cursor--,A.bra=A.cursor,b=A.slice_to(),A.eq_v_b(b)&&A.slice_del())}}var k,b,d,f,h=[new e("pa",-1,1),new e("sti",-1,2),new e("kaan",-1,1),new e("han",-1,1),new e("kin",-1,1),new e("hän",-1,1),new e("kään",-1,1),new e("ko",-1,1),new e("pä",-1,1),new e("kö",-1,1)],p=[new e("lla",-1,-1),new e("na",-1,-1),new e("ssa",-1,-1),new e("ta",-1,-1),new e("lta",3,-1),new e("sta",3,-1)],g=[new e("llä",-1,-1),new e("nä",-1,-1),new e("ssä",-1,-1),new e("tä",-1,-1),new e("ltä",3,-1),new e("stä",3,-1)],j=[new e("lle",-1,-1),new e("ine",-1,-1)],v=[new e("nsa",-1,3),new e("mme",-1,3),new e("nne",-1,3),new e("ni",-1,2),new e("si",-1,1),new e("an",-1,4),new e("en",-1,6),new e("än",-1,5),new e("nsä",-1,3)],q=[new e("aa",-1,-1),new e("ee",-1,-1),new e("ii",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1),new e("ää",-1,-1),new e("öö",-1,-1)],C=[new e("a",-1,8),new e("lla",0,-1),new e("na",0,-1),new e("ssa",0,-1),new e("ta",0,-1),new e("lta",4,-1),new e("sta",4,-1),new e("tta",4,9),new e("lle",-1,-1),new e("ine",-1,-1),new e("ksi",-1,-1),new e("n",-1,7),new e("han",11,1),new e("den",11,-1,a),new e("seen",11,-1,l),new e("hen",11,2),new e("tten",11,-1,a),new e("hin",11,3),new e("siin",11,-1,a),new e("hon",11,4),new e("hän",11,5),new e("hön",11,6),new e("ä",-1,8),new e("llä",22,-1),new e("nä",22,-1),new e("ssä",22,-1),new e("tä",22,-1),new e("ltä",26,-1),new e("stä",26,-1),new e("ttä",26,9)],P=[new e("eja",-1,-1),new e("mma",-1,1),new e("imma",1,-1),new e("mpa",-1,1),new e("impa",3,-1),new e("mmi",-1,1),new e("immi",5,-1),new e("mpi",-1,1),new e("impi",7,-1),new e("ejä",-1,-1),new e("mmä",-1,1),new e("immä",10,-1),new e("mpä",-1,1),new e("impä",12,-1)],F=[new e("i",-1,-1),new e("j",-1,-1)],S=[new e("mma",-1,1),new e("imma",0,-1)],y=[17,1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8],W=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],x=[17,97,24,1,0,0,0,0,0,0,0,0,0,0,0,0,8,0,32],A=new r;this.setCurrent=function(i){A.setCurrent(i)},this.getCurrent=function(){return A.getCurrent()},this.stem=function(){var e=A.cursor;return i(),k=!1,A.limit_backward=e,A.cursor=A.limit,s(),A.cursor=A.limit,o(),A.cursor=A.limit,u(),A.cursor=A.limit,c(),A.cursor=A.limit,k?(m(),A.cursor=A.limit):(A.cursor=A.limit,w(),A.cursor=A.limit),_(),!0}};return function(i){return"function"==typeof i.update?i.update(function(i){return n.setCurrent(i),n.stem(),n.getCurrent()}):(n.setCurrent(i),n.stem(),n.getCurrent())}}(),i.Pipeline.registerFunction(i.fi.stemmer,"stemmer-fi"),i.fi.stopWordFilter=i.generateStopWordFilter("ei eivät emme en et ette että he heidän heidät heihin heille heillä heiltä heissä heistä heitä hän häneen hänelle hänellä häneltä hänen hänessä hänestä hänet häntä itse ja johon joiden joihin joiksi joilla joille joilta joina joissa joista joita joka joksi jolla jolle jolta jona jonka jos jossa josta jota jotka kanssa keiden keihin keiksi keille keillä keiltä keinä keissä keistä keitä keneen keneksi kenelle kenellä keneltä kenen kenenä kenessä kenestä kenet ketkä ketkä ketä koska kuin kuka kun me meidän meidät meihin meille meillä meiltä meissä meistä meitä mihin miksi mikä mille millä miltä minkä minkä minua minulla minulle minulta minun minussa minusta minut minuun minä minä missä mistä mitkä mitä mukaan mutta ne niiden niihin niiksi niille niillä niiltä niin niin niinä niissä niistä niitä noiden noihin noiksi noilla noille noilta noin noina noissa noista noita nuo nyt näiden näihin näiksi näille näillä näiltä näinä näissä näistä näitä nämä ole olemme olen olet olette oli olimme olin olisi olisimme olisin olisit olisitte olisivat olit olitte olivat olla olleet ollut on ovat poikki se sekä sen siihen siinä siitä siksi sille sillä sillä siltä sinua sinulla sinulle sinulta sinun sinussa sinusta sinut sinuun sinä sinä sitä tai te teidän teidät teihin teille teillä teiltä teissä teistä teitä tuo tuohon tuoksi tuolla tuolle tuolta tuon tuona tuossa tuosta tuota tähän täksi tälle tällä tältä tämä tämän tänä tässä tästä tätä vaan vai vaikka yli".split(" ")),i.Pipeline.registerFunction(i.fi.stopWordFilter,"stopWordFilter-fi")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.fr.min.js b/assets/javascripts/lunr/min/lunr.fr.min.js new file mode 100644 index 00000000..68cd0094 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.fr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `French` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.fr=function(){this.pipeline.reset(),this.pipeline.add(e.fr.trimmer,e.fr.stopWordFilter,e.fr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.fr.stemmer))},e.fr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.fr.trimmer=e.trimmerSupport.generateTrimmer(e.fr.wordCharacters),e.Pipeline.registerFunction(e.fr.trimmer,"trimmer-fr"),e.fr.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,s){return!(!W.eq_s(1,e)||(W.ket=W.cursor,!W.in_grouping(F,97,251)))&&(W.slice_from(r),W.cursor=s,!0)}function i(e,r,s){return!!W.eq_s(1,e)&&(W.ket=W.cursor,W.slice_from(r),W.cursor=s,!0)}function n(){for(var r,s;;){if(r=W.cursor,W.in_grouping(F,97,251)){if(W.bra=W.cursor,s=W.cursor,e("u","U",r))continue;if(W.cursor=s,e("i","I",r))continue;if(W.cursor=s,i("y","Y",r))continue}if(W.cursor=r,W.bra=r,!e("y","Y",r)){if(W.cursor=r,W.eq_s(1,"q")&&(W.bra=W.cursor,i("u","U",r)))continue;if(W.cursor=r,r>=W.limit)return;W.cursor++}}}function t(){for(;!W.in_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}for(;!W.out_grouping(F,97,251);){if(W.cursor>=W.limit)return!0;W.cursor++}return!1}function u(){var e=W.cursor;if(q=W.limit,g=q,p=q,W.in_grouping(F,97,251)&&W.in_grouping(F,97,251)&&W.cursor=W.limit){W.cursor=q;break}W.cursor++}while(!W.in_grouping(F,97,251))}q=W.cursor,W.cursor=e,t()||(g=W.cursor,t()||(p=W.cursor))}function o(){for(var e,r;;){if(r=W.cursor,W.bra=r,!(e=W.find_among(h,4)))break;switch(W.ket=W.cursor,e){case 1:W.slice_from("i");break;case 2:W.slice_from("u");break;case 3:W.slice_from("y");break;case 4:if(W.cursor>=W.limit)return;W.cursor++}}}function c(){return q<=W.cursor}function a(){return g<=W.cursor}function l(){return p<=W.cursor}function w(){var e,r;if(W.ket=W.cursor,e=W.find_among_b(C,43)){switch(W.bra=W.cursor,e){case 1:if(!l())return!1;W.slice_del();break;case 2:if(!l())return!1;W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")&&(W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU"));break;case 3:if(!l())return!1;W.slice_from("log");break;case 4:if(!l())return!1;W.slice_from("u");break;case 5:if(!l())return!1;W.slice_from("ent");break;case 6:if(!c())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(z,6))switch(W.bra=W.cursor,e){case 1:l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&W.slice_del()));break;case 2:l()?W.slice_del():a()&&W.slice_from("eux");break;case 3:l()&&W.slice_del();break;case 4:c()&&W.slice_from("i")}break;case 7:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,e=W.find_among_b(y,3))switch(W.bra=W.cursor,e){case 1:l()?W.slice_del():W.slice_from("abl");break;case 2:l()?W.slice_del():W.slice_from("iqU");break;case 3:l()&&W.slice_del()}break;case 8:if(!l())return!1;if(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"at")&&(W.bra=W.cursor,l()&&(W.slice_del(),W.ket=W.cursor,W.eq_s_b(2,"ic")))){W.bra=W.cursor,l()?W.slice_del():W.slice_from("iqU");break}break;case 9:W.slice_from("eau");break;case 10:if(!a())return!1;W.slice_from("al");break;case 11:if(l())W.slice_del();else{if(!a())return!1;W.slice_from("eux")}break;case 12:if(!a()||!W.out_grouping_b(F,97,251))return!1;W.slice_del();break;case 13:return c()&&W.slice_from("ant"),!1;case 14:return c()&&W.slice_from("ent"),!1;case 15:return r=W.limit-W.cursor,W.in_grouping_b(F,97,251)&&c()&&(W.cursor=W.limit-r,W.slice_del()),!1}return!0}return!1}function f(){var e,r;if(W.cursor=q){if(s=W.limit_backward,W.limit_backward=q,W.ket=W.cursor,e=W.find_among_b(P,7))switch(W.bra=W.cursor,e){case 1:if(l()){if(i=W.limit-W.cursor,!W.eq_s_b(1,"s")&&(W.cursor=W.limit-i,!W.eq_s_b(1,"t")))break;W.slice_del()}break;case 2:W.slice_from("i");break;case 3:W.slice_del();break;case 4:W.eq_s_b(2,"gu")&&W.slice_del()}W.limit_backward=s}}function b(){var e=W.limit-W.cursor;W.find_among_b(U,5)&&(W.cursor=W.limit-e,W.ket=W.cursor,W.cursor>W.limit_backward&&(W.cursor--,W.bra=W.cursor,W.slice_del()))}function d(){for(var e,r=1;W.out_grouping_b(F,97,251);)r--;if(r<=0){if(W.ket=W.cursor,e=W.limit-W.cursor,!W.eq_s_b(1,"é")&&(W.cursor=W.limit-e,!W.eq_s_b(1,"è")))return;W.bra=W.cursor,W.slice_from("e")}}function k(){if(!w()&&(W.cursor=W.limit,!f()&&(W.cursor=W.limit,!m())))return W.cursor=W.limit,void _();W.cursor=W.limit,W.ket=W.cursor,W.eq_s_b(1,"Y")?(W.bra=W.cursor,W.slice_from("i")):(W.cursor=W.limit,W.eq_s_b(1,"ç")&&(W.bra=W.cursor,W.slice_from("c")))}var p,g,q,v=[new r("col",-1,-1),new r("par",-1,-1),new r("tap",-1,-1)],h=[new r("",-1,4),new r("I",0,1),new r("U",0,2),new r("Y",0,3)],z=[new r("iqU",-1,3),new r("abl",-1,3),new r("Ièr",-1,4),new r("ièr",-1,4),new r("eus",-1,2),new r("iv",-1,1)],y=[new r("ic",-1,2),new r("abil",-1,1),new r("iv",-1,3)],C=[new r("iqUe",-1,1),new r("atrice",-1,2),new r("ance",-1,1),new r("ence",-1,5),new r("logie",-1,3),new r("able",-1,1),new r("isme",-1,1),new r("euse",-1,11),new r("iste",-1,1),new r("ive",-1,8),new r("if",-1,8),new r("usion",-1,4),new r("ation",-1,2),new r("ution",-1,4),new r("ateur",-1,2),new r("iqUes",-1,1),new r("atrices",-1,2),new r("ances",-1,1),new r("ences",-1,5),new r("logies",-1,3),new r("ables",-1,1),new r("ismes",-1,1),new r("euses",-1,11),new r("istes",-1,1),new r("ives",-1,8),new r("ifs",-1,8),new r("usions",-1,4),new r("ations",-1,2),new r("utions",-1,4),new r("ateurs",-1,2),new r("ments",-1,15),new r("ements",30,6),new r("issements",31,12),new r("ités",-1,7),new r("ment",-1,15),new r("ement",34,6),new r("issement",35,12),new r("amment",34,13),new r("emment",34,14),new r("aux",-1,10),new r("eaux",39,9),new r("eux",-1,1),new r("ité",-1,7)],x=[new r("ira",-1,1),new r("ie",-1,1),new r("isse",-1,1),new r("issante",-1,1),new r("i",-1,1),new r("irai",4,1),new r("ir",-1,1),new r("iras",-1,1),new r("ies",-1,1),new r("îmes",-1,1),new r("isses",-1,1),new r("issantes",-1,1),new r("îtes",-1,1),new r("is",-1,1),new r("irais",13,1),new r("issais",13,1),new r("irions",-1,1),new r("issions",-1,1),new r("irons",-1,1),new r("issons",-1,1),new r("issants",-1,1),new r("it",-1,1),new r("irait",21,1),new r("issait",21,1),new r("issant",-1,1),new r("iraIent",-1,1),new r("issaIent",-1,1),new r("irent",-1,1),new r("issent",-1,1),new r("iront",-1,1),new r("ît",-1,1),new r("iriez",-1,1),new r("issiez",-1,1),new r("irez",-1,1),new r("issez",-1,1)],I=[new r("a",-1,3),new r("era",0,2),new r("asse",-1,3),new r("ante",-1,3),new r("ée",-1,2),new r("ai",-1,3),new r("erai",5,2),new r("er",-1,2),new r("as",-1,3),new r("eras",8,2),new r("âmes",-1,3),new r("asses",-1,3),new r("antes",-1,3),new r("âtes",-1,3),new r("ées",-1,2),new r("ais",-1,3),new r("erais",15,2),new r("ions",-1,1),new r("erions",17,2),new r("assions",17,3),new r("erons",-1,2),new r("ants",-1,3),new r("és",-1,2),new r("ait",-1,3),new r("erait",23,2),new r("ant",-1,3),new r("aIent",-1,3),new r("eraIent",26,2),new r("èrent",-1,2),new r("assent",-1,3),new r("eront",-1,2),new r("ât",-1,3),new r("ez",-1,2),new r("iez",32,2),new r("eriez",33,2),new r("assiez",33,3),new r("erez",32,2),new r("é",-1,2)],P=[new r("e",-1,3),new r("Ière",0,2),new r("ière",0,2),new r("ion",-1,1),new r("Ier",-1,2),new r("ier",-1,2),new r("ë",-1,4)],U=[new r("ell",-1,-1),new r("eill",-1,-1),new r("enn",-1,-1),new r("onn",-1,-1),new r("ett",-1,-1)],F=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,128,130,103,8,5],S=[1,65,20,0,0,0,0,0,0,0,0,0,0,0,0,0,128],W=new s;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){var e=W.cursor;return n(),W.cursor=e,u(),W.limit_backward=e,W.cursor=W.limit,k(),W.cursor=W.limit,b(),W.cursor=W.limit,d(),W.cursor=W.limit_backward,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.fr.stemmer,"stemmer-fr"),e.fr.stopWordFilter=e.generateStopWordFilter("ai aie aient aies ait as au aura aurai auraient aurais aurait auras aurez auriez aurions aurons auront aux avaient avais avait avec avez aviez avions avons ayant ayez ayons c ce ceci celà ces cet cette d dans de des du elle en es est et eu eue eues eurent eus eusse eussent eusses eussiez eussions eut eux eûmes eût eûtes furent fus fusse fussent fusses fussiez fussions fut fûmes fût fûtes ici il ils j je l la le les leur leurs lui m ma mais me mes moi mon même n ne nos notre nous on ont ou par pas pour qu que quel quelle quelles quels qui s sa sans se sera serai seraient serais serait seras serez seriez serions serons seront ses soi soient sois soit sommes son sont soyez soyons suis sur t ta te tes toi ton tu un une vos votre vous y à étaient étais était étant étiez étions été étée étées étés êtes".split(" ")),e.Pipeline.registerFunction(e.fr.stopWordFilter,"stopWordFilter-fr")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.hi.min.js b/assets/javascripts/lunr/min/lunr.hi.min.js new file mode 100644 index 00000000..7dbc4140 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.hi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hi=function(){this.pipeline.reset(),this.pipeline.add(e.hi.trimmer,e.hi.stopWordFilter,e.hi.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hi.stemmer))},e.hi.wordCharacters="ऀ-ःऄ-एऐ-टठ-यर-िी-ॏॐ-य़ॠ-९॰-ॿa-zA-Zａ-ｚＡ-Ｚ0-9０-９",e.hi.trimmer=e.trimmerSupport.generateTrimmer(e.hi.wordCharacters),e.Pipeline.registerFunction(e.hi.trimmer,"trimmer-hi"),e.hi.stopWordFilter=e.generateStopWordFilter("अत अपना अपनी अपने अभी अंदर आदि आप इत्यादि इन इनका इन्हीं इन्हें इन्हों इस इसका इसकी इसके इसमें इसी इसे उन उनका उनकी उनके उनको उन्हीं उन्हें उन्हों उस उसके उसी उसे एक एवं एस ऐसे और कई कर करता करते करना करने करें कहते कहा का काफ़ी कि कितना किन्हें किन्हों किया किर किस किसी किसे की कुछ कुल के को कोई कौन कौनसा गया घर जब जहाँ जा जितना जिन जिन्हें जिन्हों जिस जिसे जीधर जैसा जैसे जो तक तब तरह तिन तिन्हें तिन्हों तिस तिसे तो था थी थे दबारा दिया दुसरा दूसरे दो द्वारा न नके नहीं ना निहायत नीचे ने पर पहले पूरा पे फिर बनी बही बहुत बाद बाला बिलकुल भी भीतर मगर मानो मे में यदि यह यहाँ यही या यिह ये रखें रहा रहे ऱ्वासा लिए लिये लेकिन व वग़ैरह वर्ग वह वहाँ वहीं वाले वुह वे वो सकता सकते सबसे सभी साथ साबुत साभ सारा से सो संग ही हुआ हुई हुए है हैं हो होता होती होते होना होने".split(" ")),e.hi.stemmer=function(){return function(e){return"function"==typeof e.update?e.update(function(e){return e}):e}}();var r=e.wordcut;r.init(),e.hi.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(r){return isLunr2?new e.Token(r.toLowerCase()):r.toLowerCase()});var t=i.toString().toLowerCase().replace(/^\s+/,"");return r.cut(t).split("|")},e.Pipeline.registerFunction(e.hi.stemmer,"stemmer-hi"),e.Pipeline.registerFunction(e.hi.stopWordFilter,"stopWordFilter-hi")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.hu.min.js b/assets/javascripts/lunr/min/lunr.hu.min.js new file mode 100644 index 00000000..ed9d909f --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.hu.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Hungarian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.hu=function(){this.pipeline.reset(),this.pipeline.add(e.hu.trimmer,e.hu.stopWordFilter,e.hu.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.hu.stemmer))},e.hu.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.hu.trimmer=e.trimmerSupport.generateTrimmer(e.hu.wordCharacters),e.Pipeline.registerFunction(e.hu.trimmer,"trimmer-hu"),e.hu.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,n=L.cursor;if(d=L.limit,L.in_grouping(W,97,252))for(;;){if(e=L.cursor,L.out_grouping(W,97,252))return L.cursor=e,L.find_among(g,8)||(L.cursor=e,e=L.limit)return void(d=e);L.cursor++}if(L.cursor=n,L.out_grouping(W,97,252)){for(;!L.in_grouping(W,97,252);){if(L.cursor>=L.limit)return;L.cursor++}d=L.cursor}}function i(){return d<=L.cursor}function a(){var e;if(L.ket=L.cursor,(e=L.find_among_b(h,2))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e")}}function t(){var e=L.limit-L.cursor;return!!L.find_among_b(p,23)&&(L.cursor=L.limit-e,!0)}function s(){if(L.cursor>L.limit_backward){L.cursor--,L.ket=L.cursor;var e=L.cursor-1;L.limit_backward<=e&&e<=L.limit&&(L.cursor=e,L.bra=e,L.slice_del())}}function c(){var e;if(L.ket=L.cursor,(e=L.find_among_b(_,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function o(){L.ket=L.cursor,L.find_among_b(v,44)&&(L.bra=L.cursor,i()&&(L.slice_del(),a()))}function w(){var e;if(L.ket=L.cursor,(e=L.find_among_b(z,3))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("e");break;case 2:case 3:L.slice_from("a")}}function l(){var e;if(L.ket=L.cursor,(e=L.find_among_b(y,6))&&(L.bra=L.cursor,i()))switch(e){case 1:case 2:L.slice_del();break;case 3:L.slice_from("a");break;case 4:L.slice_from("e")}}function u(){var e;if(L.ket=L.cursor,(e=L.find_among_b(j,2))&&(L.bra=L.cursor,i())){if((1==e||2==e)&&!t())return;L.slice_del(),s()}}function m(){var e;if(L.ket=L.cursor,(e=L.find_among_b(C,7))&&(L.bra=L.cursor,i()))switch(e){case 1:L.slice_from("a");break;case 2:L.slice_from("e");break;case 3:case 4:case 5:case 6:case 7:L.slice_del()}}function k(){var e;if(L.ket=L.cursor,(e=L.find_among_b(P,12))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 9:L.slice_del();break;case 2:case 5:case 8:L.slice_from("e");break;case 3:case 6:L.slice_from("a")}}function f(){var e;if(L.ket=L.cursor,(e=L.find_among_b(F,31))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 7:case 8:case 9:case 12:case 13:case 16:case 17:case 18:L.slice_del();break;case 2:case 5:case 10:case 14:case 19:L.slice_from("a");break;case 3:case 6:case 11:case 15:case 20:L.slice_from("e")}}function b(){var e;if(L.ket=L.cursor,(e=L.find_among_b(S,42))&&(L.bra=L.cursor,i()))switch(e){case 1:case 4:case 5:case 6:case 9:case 10:case 11:case 14:case 15:case 16:case 17:case 20:case 21:case 24:case 25:case 26:case 29:L.slice_del();break;case 2:case 7:case 12:case 18:case 22:case 27:L.slice_from("a");break;case 3:case 8:case 13:case 19:case 23:case 28:L.slice_from("e")}}var d,g=[new n("cs",-1,-1),new n("dzs",-1,-1),new n("gy",-1,-1),new n("ly",-1,-1),new n("ny",-1,-1),new n("sz",-1,-1),new n("ty",-1,-1),new n("zs",-1,-1)],h=[new n("á",-1,1),new n("é",-1,2)],p=[new n("bb",-1,-1),new n("cc",-1,-1),new n("dd",-1,-1),new n("ff",-1,-1),new n("gg",-1,-1),new n("jj",-1,-1),new n("kk",-1,-1),new n("ll",-1,-1),new n("mm",-1,-1),new n("nn",-1,-1),new n("pp",-1,-1),new n("rr",-1,-1),new n("ccs",-1,-1),new n("ss",-1,-1),new n("zzs",-1,-1),new n("tt",-1,-1),new n("vv",-1,-1),new n("ggy",-1,-1),new n("lly",-1,-1),new n("nny",-1,-1),new n("tty",-1,-1),new n("ssz",-1,-1),new n("zz",-1,-1)],_=[new n("al",-1,1),new n("el",-1,2)],v=[new n("ba",-1,-1),new n("ra",-1,-1),new n("be",-1,-1),new n("re",-1,-1),new n("ig",-1,-1),new n("nak",-1,-1),new n("nek",-1,-1),new n("val",-1,-1),new n("vel",-1,-1),new n("ul",-1,-1),new n("nál",-1,-1),new n("nél",-1,-1),new n("ból",-1,-1),new n("ról",-1,-1),new n("tól",-1,-1),new n("bõl",-1,-1),new n("rõl",-1,-1),new n("tõl",-1,-1),new n("ül",-1,-1),new n("n",-1,-1),new n("an",19,-1),new n("ban",20,-1),new n("en",19,-1),new n("ben",22,-1),new n("képpen",22,-1),new n("on",19,-1),new n("ön",19,-1),new n("képp",-1,-1),new n("kor",-1,-1),new n("t",-1,-1),new n("at",29,-1),new n("et",29,-1),new n("ként",29,-1),new n("anként",32,-1),new n("enként",32,-1),new n("onként",32,-1),new n("ot",29,-1),new n("ért",29,-1),new n("öt",29,-1),new n("hez",-1,-1),new n("hoz",-1,-1),new n("höz",-1,-1),new n("vá",-1,-1),new n("vé",-1,-1)],z=[new n("án",-1,2),new n("én",-1,1),new n("ánként",-1,3)],y=[new n("stul",-1,2),new n("astul",0,1),new n("ástul",0,3),new n("stül",-1,2),new n("estül",3,1),new n("éstül",3,4)],j=[new n("á",-1,1),new n("é",-1,2)],C=[new n("k",-1,7),new n("ak",0,4),new n("ek",0,6),new n("ok",0,5),new n("ák",0,1),new n("ék",0,2),new n("ök",0,3)],P=[new n("éi",-1,7),new n("áéi",0,6),new n("ééi",0,5),new n("é",-1,9),new n("ké",3,4),new n("aké",4,1),new n("eké",4,1),new n("oké",4,1),new n("áké",4,3),new n("éké",4,2),new n("öké",4,1),new n("éé",3,8)],F=[new n("a",-1,18),new n("ja",0,17),new n("d",-1,16),new n("ad",2,13),new n("ed",2,13),new n("od",2,13),new n("ád",2,14),new n("éd",2,15),new n("öd",2,13),new n("e",-1,18),new n("je",9,17),new n("nk",-1,4),new n("unk",11,1),new n("ánk",11,2),new n("énk",11,3),new n("ünk",11,1),new n("uk",-1,8),new n("juk",16,7),new n("ájuk",17,5),new n("ük",-1,8),new n("jük",19,7),new n("éjük",20,6),new n("m",-1,12),new n("am",22,9),new n("em",22,9),new n("om",22,9),new n("ám",22,10),new n("ém",22,11),new n("o",-1,18),new n("á",-1,19),new n("é",-1,20)],S=[new n("id",-1,10),new n("aid",0,9),new n("jaid",1,6),new n("eid",0,9),new n("jeid",3,6),new n("áid",0,7),new n("éid",0,8),new n("i",-1,15),new n("ai",7,14),new n("jai",8,11),new n("ei",7,14),new n("jei",10,11),new n("ái",7,12),new n("éi",7,13),new n("itek",-1,24),new n("eitek",14,21),new n("jeitek",15,20),new n("éitek",14,23),new n("ik",-1,29),new n("aik",18,26),new n("jaik",19,25),new n("eik",18,26),new n("jeik",21,25),new n("áik",18,27),new n("éik",18,28),new n("ink",-1,20),new n("aink",25,17),new n("jaink",26,16),new n("eink",25,17),new n("jeink",28,16),new n("áink",25,18),new n("éink",25,19),new n("aitok",-1,21),new n("jaitok",32,20),new n("áitok",-1,22),new n("im",-1,5),new n("aim",35,4),new n("jaim",36,1),new n("eim",35,4),new n("jeim",38,1),new n("áim",35,2),new n("éim",35,3)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,1,17,52,14],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var n=L.cursor;return e(),L.limit_backward=n,L.cursor=L.limit,c(),L.cursor=L.limit,o(),L.cursor=L.limit,w(),L.cursor=L.limit,l(),L.cursor=L.limit,u(),L.cursor=L.limit,k(),L.cursor=L.limit,f(),L.cursor=L.limit,b(),L.cursor=L.limit,m(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.hu.stemmer,"stemmer-hu"),e.hu.stopWordFilter=e.generateStopWordFilter("a abban ahhoz ahogy ahol aki akik akkor alatt amely amelyek amelyekben amelyeket amelyet amelynek ami amikor amit amolyan amíg annak arra arról az azok azon azonban azt aztán azután azzal azért be belül benne bár cikk cikkek cikkeket csak de e ebben eddig egy egyes egyetlen egyik egyre egyéb egész ehhez ekkor el ellen elsõ elég elõ elõször elõtt emilyen ennek erre ez ezek ezen ezt ezzel ezért fel felé hanem hiszen hogy hogyan igen ill ill. illetve ilyen ilyenkor ismét ison itt jobban jó jól kell kellett keressünk keresztül ki kívül között közül legalább legyen lehet lehetett lenne lenni lesz lett maga magát majd majd meg mellett mely melyek mert mi mikor milyen minden mindenki mindent mindig mint mintha mit mivel miért most már más másik még míg nagy nagyobb nagyon ne nekem neki nem nincs néha néhány nélkül olyan ott pedig persze rá s saját sem semmi sok sokat sokkal szemben szerint szinte számára talán tehát teljes tovább továbbá több ugyanis utolsó után utána vagy vagyis vagyok valaki valami valamint való van vannak vele vissza viszont volna volt voltak voltam voltunk által általában át én éppen és így õ õk õket össze úgy új újabb újra".split(" ")),e.Pipeline.registerFunction(e.hu.stopWordFilter,"stopWordFilter-hu")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.it.min.js b/assets/javascripts/lunr/min/lunr.it.min.js new file mode 100644 index 00000000..344b6a3c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.it.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Italian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.it=function(){this.pipeline.reset(),this.pipeline.add(e.it.trimmer,e.it.stopWordFilter,e.it.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.it.stemmer))},e.it.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.it.trimmer=e.trimmerSupport.generateTrimmer(e.it.wordCharacters),e.Pipeline.registerFunction(e.it.trimmer,"trimmer-it"),e.it.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(e,r,n){return!(!x.eq_s(1,e)||(x.ket=x.cursor,!x.in_grouping(L,97,249)))&&(x.slice_from(r),x.cursor=n,!0)}function i(){for(var r,n,i,o,t=x.cursor;;){if(x.bra=x.cursor,r=x.find_among(h,7))switch(x.ket=x.cursor,r){case 1:x.slice_from("à");continue;case 2:x.slice_from("è");continue;case 3:x.slice_from("ì");continue;case 4:x.slice_from("ò");continue;case 5:x.slice_from("ù");continue;case 6:x.slice_from("qU");continue;case 7:if(x.cursor>=x.limit)break;x.cursor++;continue}break}for(x.cursor=t;;)for(n=x.cursor;;){if(i=x.cursor,x.in_grouping(L,97,249)){if(x.bra=x.cursor,o=x.cursor,e("u","U",i))break;if(x.cursor=o,e("i","I",i))break}if(x.cursor=i,x.cursor>=x.limit)return void(x.cursor=n);x.cursor++}}function o(e){if(x.cursor=e,!x.in_grouping(L,97,249))return!1;for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function t(){if(x.in_grouping(L,97,249)){var e=x.cursor;if(x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return o(e);x.cursor++}return!0}return o(e)}return!1}function s(){var e,r=x.cursor;if(!t()){if(x.cursor=r,!x.out_grouping(L,97,249))return;if(e=x.cursor,x.out_grouping(L,97,249)){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return x.cursor=e,void(x.in_grouping(L,97,249)&&x.cursor=x.limit)return;x.cursor++}k=x.cursor}function a(){for(;!x.in_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}for(;!x.out_grouping(L,97,249);){if(x.cursor>=x.limit)return!1;x.cursor++}return!0}function u(){var e=x.cursor;k=x.limit,p=k,g=k,s(),x.cursor=e,a()&&(p=x.cursor,a()&&(g=x.cursor))}function c(){for(var e;;){if(x.bra=x.cursor,!(e=x.find_among(q,3)))break;switch(x.ket=x.cursor,e){case 1:x.slice_from("i");break;case 2:x.slice_from("u");break;case 3:if(x.cursor>=x.limit)return;x.cursor++}}}function w(){return k<=x.cursor}function l(){return p<=x.cursor}function m(){return g<=x.cursor}function f(){var e;if(x.ket=x.cursor,x.find_among_b(C,37)&&(x.bra=x.cursor,(e=x.find_among_b(z,5))&&w()))switch(e){case 1:x.slice_del();break;case 2:x.slice_from("e")}}function v(){var e;if(x.ket=x.cursor,!(e=x.find_among_b(S,51)))return!1;switch(x.bra=x.cursor,e){case 1:if(!m())return!1;x.slice_del();break;case 2:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del());break;case 3:if(!m())return!1;x.slice_from("log");break;case 4:if(!m())return!1;x.slice_from("u");break;case 5:if(!m())return!1;x.slice_from("ente");break;case 6:if(!w())return!1;x.slice_del();break;case 7:if(!l())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(P,4),e&&(x.bra=x.cursor,m()&&(x.slice_del(),1==e&&(x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&x.slice_del()))));break;case 8:if(!m())return!1;x.slice_del(),x.ket=x.cursor,e=x.find_among_b(F,3),e&&(x.bra=x.cursor,1==e&&m()&&x.slice_del());break;case 9:if(!m())return!1;x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"at")&&(x.bra=x.cursor,m()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(2,"ic")&&(x.bra=x.cursor,m()&&x.slice_del())))}return!0}function b(){var e,r;x.cursor>=k&&(r=x.limit_backward,x.limit_backward=k,x.ket=x.cursor,e=x.find_among_b(W,87),e&&(x.bra=x.cursor,1==e&&x.slice_del()),x.limit_backward=r)}function d(){var e=x.limit-x.cursor;if(x.ket=x.cursor,x.in_grouping_b(y,97,242)&&(x.bra=x.cursor,w()&&(x.slice_del(),x.ket=x.cursor,x.eq_s_b(1,"i")&&(x.bra=x.cursor,w()))))return void x.slice_del();x.cursor=x.limit-e}function _(){d(),x.ket=x.cursor,x.eq_s_b(1,"h")&&(x.bra=x.cursor,x.in_grouping_b(U,99,103)&&w()&&x.slice_del())}var g,p,k,h=[new r("",-1,7),new r("qu",0,6),new r("á",0,1),new r("é",0,2),new r("í",0,3),new r("ó",0,4),new r("ú",0,5)],q=[new r("",-1,3),new r("I",0,1),new r("U",0,2)],C=[new r("la",-1,-1),new r("cela",0,-1),new r("gliela",0,-1),new r("mela",0,-1),new r("tela",0,-1),new r("vela",0,-1),new r("le",-1,-1),new r("cele",6,-1),new r("gliele",6,-1),new r("mele",6,-1),new r("tele",6,-1),new r("vele",6,-1),new r("ne",-1,-1),new r("cene",12,-1),new r("gliene",12,-1),new r("mene",12,-1),new r("sene",12,-1),new r("tene",12,-1),new r("vene",12,-1),new r("ci",-1,-1),new r("li",-1,-1),new r("celi",20,-1),new r("glieli",20,-1),new r("meli",20,-1),new r("teli",20,-1),new r("veli",20,-1),new r("gli",20,-1),new r("mi",-1,-1),new r("si",-1,-1),new r("ti",-1,-1),new r("vi",-1,-1),new r("lo",-1,-1),new r("celo",31,-1),new r("glielo",31,-1),new r("melo",31,-1),new r("telo",31,-1),new r("velo",31,-1)],z=[new r("ando",-1,1),new r("endo",-1,1),new r("ar",-1,2),new r("er",-1,2),new r("ir",-1,2)],P=[new r("ic",-1,-1),new r("abil",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],F=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],S=[new r("ica",-1,1),new r("logia",-1,3),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,9),new r("anza",-1,1),new r("enza",-1,5),new r("ice",-1,1),new r("atrice",7,1),new r("iche",-1,1),new r("logie",-1,3),new r("abile",-1,1),new r("ibile",-1,1),new r("usione",-1,4),new r("azione",-1,2),new r("uzione",-1,4),new r("atore",-1,2),new r("ose",-1,1),new r("ante",-1,1),new r("mente",-1,1),new r("amente",19,7),new r("iste",-1,1),new r("ive",-1,9),new r("anze",-1,1),new r("enze",-1,5),new r("ici",-1,1),new r("atrici",25,1),new r("ichi",-1,1),new r("abili",-1,1),new r("ibili",-1,1),new r("ismi",-1,1),new r("usioni",-1,4),new r("azioni",-1,2),new r("uzioni",-1,4),new r("atori",-1,2),new r("osi",-1,1),new r("anti",-1,1),new r("amenti",-1,6),new r("imenti",-1,6),new r("isti",-1,1),new r("ivi",-1,9),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,6),new r("imento",-1,6),new r("ivo",-1,9),new r("ità",-1,8),new r("istà",-1,1),new r("istè",-1,1),new r("istì",-1,1)],W=[new r("isca",-1,1),new r("enda",-1,1),new r("ata",-1,1),new r("ita",-1,1),new r("uta",-1,1),new r("ava",-1,1),new r("eva",-1,1),new r("iva",-1,1),new r("erebbe",-1,1),new r("irebbe",-1,1),new r("isce",-1,1),new r("ende",-1,1),new r("are",-1,1),new r("ere",-1,1),new r("ire",-1,1),new r("asse",-1,1),new r("ate",-1,1),new r("avate",16,1),new r("evate",16,1),new r("ivate",16,1),new r("ete",-1,1),new r("erete",20,1),new r("irete",20,1),new r("ite",-1,1),new r("ereste",-1,1),new r("ireste",-1,1),new r("ute",-1,1),new r("erai",-1,1),new r("irai",-1,1),new r("isci",-1,1),new r("endi",-1,1),new r("erei",-1,1),new r("irei",-1,1),new r("assi",-1,1),new r("ati",-1,1),new r("iti",-1,1),new r("eresti",-1,1),new r("iresti",-1,1),new r("uti",-1,1),new r("avi",-1,1),new r("evi",-1,1),new r("ivi",-1,1),new r("isco",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("Yamo",-1,1),new r("iamo",-1,1),new r("avamo",-1,1),new r("evamo",-1,1),new r("ivamo",-1,1),new r("eremo",-1,1),new r("iremo",-1,1),new r("assimo",-1,1),new r("ammo",-1,1),new r("emmo",-1,1),new r("eremmo",54,1),new r("iremmo",54,1),new r("immo",-1,1),new r("ano",-1,1),new r("iscano",58,1),new r("avano",58,1),new r("evano",58,1),new r("ivano",58,1),new r("eranno",-1,1),new r("iranno",-1,1),new r("ono",-1,1),new r("iscono",65,1),new r("arono",65,1),new r("erono",65,1),new r("irono",65,1),new r("erebbero",-1,1),new r("irebbero",-1,1),new r("assero",-1,1),new r("essero",-1,1),new r("issero",-1,1),new r("ato",-1,1),new r("ito",-1,1),new r("uto",-1,1),new r("avo",-1,1),new r("evo",-1,1),new r("ivo",-1,1),new r("ar",-1,1),new r("ir",-1,1),new r("erà",-1,1),new r("irà",-1,1),new r("erò",-1,1),new r("irò",-1,1)],L=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2,1],y=[17,65,0,0,0,0,0,0,0,0,0,0,0,0,0,128,128,8,2],U=[17],x=new n;this.setCurrent=function(e){x.setCurrent(e)},this.getCurrent=function(){return x.getCurrent()},this.stem=function(){var e=x.cursor;return i(),x.cursor=e,u(),x.limit_backward=e,x.cursor=x.limit,f(),x.cursor=x.limit,v()||(x.cursor=x.limit,b()),x.cursor=x.limit,_(),x.cursor=x.limit_backward,c(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.it.stemmer,"stemmer-it"),e.it.stopWordFilter=e.generateStopWordFilter("a abbia abbiamo abbiano abbiate ad agl agli ai al all alla alle allo anche avemmo avendo avesse avessero avessi avessimo aveste avesti avete aveva avevamo avevano avevate avevi avevo avrai avranno avrebbe avrebbero avrei avremmo avremo avreste avresti avrete avrà avrò avuta avute avuti avuto c che chi ci coi col come con contro cui da dagl dagli dai dal dall dalla dalle dallo degl degli dei del dell della delle dello di dov dove e ebbe ebbero ebbi ed era erano eravamo eravate eri ero essendo faccia facciamo facciano facciate faccio facemmo facendo facesse facessero facessi facessimo faceste facesti faceva facevamo facevano facevate facevi facevo fai fanno farai faranno farebbe farebbero farei faremmo faremo fareste faresti farete farà farò fece fecero feci fosse fossero fossi fossimo foste fosti fu fui fummo furono gli ha hai hanno ho i il in io l la le lei li lo loro lui ma mi mia mie miei mio ne negl negli nei nel nell nella nelle nello noi non nostra nostre nostri nostro o per perché più quale quanta quante quanti quanto quella quelle quelli quello questa queste questi questo sarai saranno sarebbe sarebbero sarei saremmo saremo sareste saresti sarete sarà sarò se sei si sia siamo siano siate siete sono sta stai stando stanno starai staranno starebbe starebbero starei staremmo staremo stareste staresti starete starà starò stava stavamo stavano stavate stavi stavo stemmo stesse stessero stessi stessimo steste stesti stette stettero stetti stia stiamo stiano stiate sto su sua sue sugl sugli sui sul sull sulla sulle sullo suo suoi ti tra tu tua tue tuo tuoi tutti tutto un una uno vi voi vostra vostre vostri vostro è".split(" ")),e.Pipeline.registerFunction(e.it.stopWordFilter,"stopWordFilter-it")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ja.min.js b/assets/javascripts/lunr/min/lunr.ja.min.js new file mode 100644 index 00000000..5f254ebe --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ja.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.ja=function(){this.pipeline.reset(),this.pipeline.add(e.ja.trimmer,e.ja.stopWordFilter,e.ja.stemmer),r?this.tokenizer=e.ja.tokenizer:(e.tokenizer&&(e.tokenizer=e.ja.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.ja.tokenizer))};var t=new e.TinySegmenter;e.ja.tokenizer=function(i){var n,o,s,p,a,u,m,l,c,f;if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t.toLowerCase()):t.toLowerCase()});for(o=i.toString().toLowerCase().replace(/^\s+/,""),n=o.length-1;n>=0;n--)if(/\S/.test(o.charAt(n))){o=o.substring(0,n+1);break}for(a=[],s=o.length,c=0,l=0;c<=s;c++)if(u=o.charAt(c),m=c-l,u.match(/\s/)||c==s){if(m>0)for(p=t.segment(o.slice(l,c)).filter(function(e){return!!e}),f=l,n=0;n=C.limit)break;C.cursor++;continue}break}for(C.cursor=o,C.bra=o,C.eq_s(1,"y")?(C.ket=C.cursor,C.slice_from("Y")):C.cursor=o;;)if(e=C.cursor,C.in_grouping(q,97,232)){if(i=C.cursor,C.bra=i,C.eq_s(1,"i"))C.ket=C.cursor,C.in_grouping(q,97,232)&&(C.slice_from("I"),C.cursor=e);else if(C.cursor=i,C.eq_s(1,"y"))C.ket=C.cursor,C.slice_from("Y"),C.cursor=e;else if(n(e))break}else if(n(e))break}function n(r){return C.cursor=r,r>=C.limit||(C.cursor++,!1)}function o(){_=C.limit,d=_,t()||(_=C.cursor,_<3&&(_=3),t()||(d=C.cursor))}function t(){for(;!C.in_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}for(;!C.out_grouping(q,97,232);){if(C.cursor>=C.limit)return!0;C.cursor++}return!1}function s(){for(var r;;)if(C.bra=C.cursor,r=C.find_among(p,3))switch(C.ket=C.cursor,r){case 1:C.slice_from("y");break;case 2:C.slice_from("i");break;case 3:if(C.cursor>=C.limit)return;C.cursor++}}function u(){return _<=C.cursor}function c(){return d<=C.cursor}function a(){var r=C.limit-C.cursor;C.find_among_b(g,3)&&(C.cursor=C.limit-r,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del()))}function l(){var r;w=!1,C.ket=C.cursor,C.eq_s_b(1,"e")&&(C.bra=C.cursor,u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.slice_del(),w=!0,a())))}function m(){var r;u()&&(r=C.limit-C.cursor,C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-r,C.eq_s_b(3,"gem")||(C.cursor=C.limit-r,C.slice_del(),a())))}function f(){var r,e,i,n,o,t,s=C.limit-C.cursor;if(C.ket=C.cursor,r=C.find_among_b(h,5))switch(C.bra=C.cursor,r){case 1:u()&&C.slice_from("heid");break;case 2:m();break;case 3:u()&&C.out_grouping_b(j,97,232)&&C.slice_del()}if(C.cursor=C.limit-s,l(),C.cursor=C.limit-s,C.ket=C.cursor,C.eq_s_b(4,"heid")&&(C.bra=C.cursor,c()&&(e=C.limit-C.cursor,C.eq_s_b(1,"c")||(C.cursor=C.limit-e,C.slice_del(),C.ket=C.cursor,C.eq_s_b(2,"en")&&(C.bra=C.cursor,m())))),C.cursor=C.limit-s,C.ket=C.cursor,r=C.find_among_b(k,6))switch(C.bra=C.cursor,r){case 1:if(c()){if(C.slice_del(),i=C.limit-C.cursor,C.ket=C.cursor,C.eq_s_b(2,"ig")&&(C.bra=C.cursor,c()&&(n=C.limit-C.cursor,!C.eq_s_b(1,"e")))){C.cursor=C.limit-n,C.slice_del();break}C.cursor=C.limit-i,a()}break;case 2:c()&&(o=C.limit-C.cursor,C.eq_s_b(1,"e")||(C.cursor=C.limit-o,C.slice_del()));break;case 3:c()&&(C.slice_del(),l());break;case 4:c()&&C.slice_del();break;case 5:c()&&w&&C.slice_del()}C.cursor=C.limit-s,C.out_grouping_b(z,73,232)&&(t=C.limit-C.cursor,C.find_among_b(v,4)&&C.out_grouping_b(q,97,232)&&(C.cursor=C.limit-t,C.ket=C.cursor,C.cursor>C.limit_backward&&(C.cursor--,C.bra=C.cursor,C.slice_del())))}var d,_,w,b=[new e("",-1,6),new e("á",0,1),new e("ä",0,1),new e("é",0,2),new e("ë",0,2),new e("í",0,3),new e("ï",0,3),new e("ó",0,4),new e("ö",0,4),new e("ú",0,5),new e("ü",0,5)],p=[new e("",-1,3),new e("I",0,2),new e("Y",0,1)],g=[new e("dd",-1,-1),new e("kk",-1,-1),new e("tt",-1,-1)],h=[new e("ene",-1,2),new e("se",-1,3),new e("en",-1,2),new e("heden",2,1),new e("s",-1,3)],k=[new e("end",-1,1),new e("ig",-1,2),new e("ing",-1,1),new e("lijk",-1,3),new e("baar",-1,4),new e("bar",-1,5)],v=[new e("aa",-1,-1),new e("ee",-1,-1),new e("oo",-1,-1),new e("uu",-1,-1)],q=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],z=[1,0,0,17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],j=[17,67,16,1,0,0,0,0,0,0,0,0,0,0,0,0,128],C=new i;this.setCurrent=function(r){C.setCurrent(r)},this.getCurrent=function(){return C.getCurrent()},this.stem=function(){var e=C.cursor;return r(),C.cursor=e,o(),C.limit_backward=e,C.cursor=C.limit,f(),C.cursor=C.limit_backward,s(),!0}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.nl.stemmer,"stemmer-nl"),r.nl.stopWordFilter=r.generateStopWordFilter(" aan al alles als altijd andere ben bij daar dan dat de der deze die dit doch doen door dus een eens en er ge geen geweest haar had heb hebben heeft hem het hier hij hoe hun iemand iets ik in is ja je kan kon kunnen maar me meer men met mij mijn moet na naar niet niets nog nu of om omdat onder ons ook op over reeds te tegen toch toen tot u uit uw van veel voor want waren was wat werd wezen wie wil worden wordt zal ze zelf zich zij zijn zo zonder zou".split(" ")),r.Pipeline.registerFunction(r.nl.stopWordFilter,"stopWordFilter-nl")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.no.min.js b/assets/javascripts/lunr/min/lunr.no.min.js new file mode 100644 index 00000000..92bc7e4e --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.no.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Norwegian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.no=function(){this.pipeline.reset(),this.pipeline.add(e.no.trimmer,e.no.stopWordFilter,e.no.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.no.stemmer))},e.no.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.no.trimmer=e.trimmerSupport.generateTrimmer(e.no.wordCharacters),e.Pipeline.registerFunction(e.no.trimmer,"trimmer-no"),e.no.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,i=new function(){function e(){var e,r=w.cursor+3;if(a=w.limit,0<=r||r<=w.limit){for(s=r;;){if(e=w.cursor,w.in_grouping(d,97,248)){w.cursor=e;break}if(e>=w.limit)return;w.cursor=e+1}for(;!w.out_grouping(d,97,248);){if(w.cursor>=w.limit)return;w.cursor++}a=w.cursor,a=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(m,29),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:n=w.limit-w.cursor,w.in_grouping_b(c,98,122)?w.slice_del():(w.cursor=w.limit-n,w.eq_s_b(1,"k")&&w.out_grouping_b(d,97,248)&&w.slice_del());break;case 3:w.slice_from("er")}}function t(){var e,r=w.limit-w.cursor;w.cursor>=a&&(e=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,w.find_among_b(u,2)?(w.bra=w.cursor,w.limit_backward=e,w.cursor=w.limit-r,w.cursor>w.limit_backward&&(w.cursor--,w.bra=w.cursor,w.slice_del())):w.limit_backward=e)}function o(){var e,r;w.cursor>=a&&(r=w.limit_backward,w.limit_backward=a,w.ket=w.cursor,e=w.find_among_b(l,11),e?(w.bra=w.cursor,w.limit_backward=r,1==e&&w.slice_del()):w.limit_backward=r)}var s,a,m=[new r("a",-1,1),new r("e",-1,1),new r("ede",1,1),new r("ande",1,1),new r("ende",1,1),new r("ane",1,1),new r("ene",1,1),new r("hetene",6,1),new r("erte",1,3),new r("en",-1,1),new r("heten",9,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",12,1),new r("s",-1,2),new r("as",14,1),new r("es",14,1),new r("edes",16,1),new r("endes",16,1),new r("enes",16,1),new r("hetenes",19,1),new r("ens",14,1),new r("hetens",21,1),new r("ers",14,1),new r("ets",14,1),new r("et",-1,1),new r("het",25,1),new r("ert",-1,3),new r("ast",-1,1)],u=[new r("dt",-1,-1),new r("vt",-1,-1)],l=[new r("leg",-1,1),new r("eleg",0,1),new r("ig",-1,1),new r("eig",2,1),new r("lig",2,1),new r("elig",4,1),new r("els",-1,1),new r("lov",-1,1),new r("elov",7,1),new r("slov",7,1),new r("hetslov",9,1)],d=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,48,0,128],c=[119,125,149,1],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,i(),w.cursor=w.limit,t(),w.cursor=w.limit,o(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return i.setCurrent(e),i.stem(),i.getCurrent()}):(i.setCurrent(e),i.stem(),i.getCurrent())}}(),e.Pipeline.registerFunction(e.no.stemmer,"stemmer-no"),e.no.stopWordFilter=e.generateStopWordFilter("alle at av bare begge ble blei bli blir blitt både båe da de deg dei deim deira deires dem den denne der dere deres det dette di din disse ditt du dykk dykkar då eg ein eit eitt eller elles en enn er et ett etter for fordi fra før ha hadde han hans har hennar henne hennes her hjå ho hoe honom hoss hossen hun hva hvem hver hvilke hvilken hvis hvor hvordan hvorfor i ikke ikkje ikkje ingen ingi inkje inn inni ja jeg kan kom korleis korso kun kunne kva kvar kvarhelst kven kvi kvifor man mange me med medan meg meget mellom men mi min mine mitt mot mykje ned no noe noen noka noko nokon nokor nokre nå når og også om opp oss over på samme seg selv si si sia sidan siden sin sine sitt sjøl skal skulle slik so som som somme somt så sånn til um upp ut uten var vart varte ved vere verte vi vil ville vore vors vort vår være være vært å".split(" ")),e.Pipeline.registerFunction(e.no.stopWordFilter,"stopWordFilter-no")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.pt.min.js b/assets/javascripts/lunr/min/lunr.pt.min.js new file mode 100644 index 00000000..6c16996d --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.pt.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Portuguese` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.pt=function(){this.pipeline.reset(),this.pipeline.add(e.pt.trimmer,e.pt.stopWordFilter,e.pt.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.pt.stemmer))},e.pt.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.pt.trimmer=e.trimmerSupport.generateTrimmer(e.pt.wordCharacters),e.Pipeline.registerFunction(e.pt.trimmer,"trimmer-pt"),e.pt.stemmer=function(){var r=e.stemmerSupport.Among,s=e.stemmerSupport.SnowballProgram,n=new function(){function e(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(k,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("a~");continue;case 2:z.slice_from("o~");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function n(){if(z.out_grouping(y,97,250)){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!0;z.cursor++}return!1}return!0}function i(){if(z.in_grouping(y,97,250))for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return g=z.cursor,!0}function o(){var e,r,s=z.cursor;if(z.in_grouping(y,97,250))if(e=z.cursor,n()){if(z.cursor=e,i())return}else g=z.cursor;if(z.cursor=s,z.out_grouping(y,97,250)){if(r=z.cursor,n()){if(z.cursor=r,!z.in_grouping(y,97,250)||z.cursor>=z.limit)return;z.cursor++}g=z.cursor}}function t(){for(;!z.in_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}for(;!z.out_grouping(y,97,250);){if(z.cursor>=z.limit)return!1;z.cursor++}return!0}function a(){var e=z.cursor;g=z.limit,b=g,h=g,o(),z.cursor=e,t()&&(b=z.cursor,t()&&(h=z.cursor))}function u(){for(var e;;){if(z.bra=z.cursor,e=z.find_among(q,3))switch(z.ket=z.cursor,e){case 1:z.slice_from("ã");continue;case 2:z.slice_from("õ");continue;case 3:if(z.cursor>=z.limit)break;z.cursor++;continue}break}}function w(){return g<=z.cursor}function m(){return b<=z.cursor}function c(){return h<=z.cursor}function l(){var e;if(z.ket=z.cursor,!(e=z.find_among_b(F,45)))return!1;switch(z.bra=z.cursor,e){case 1:if(!c())return!1;z.slice_del();break;case 2:if(!c())return!1;z.slice_from("log");break;case 3:if(!c())return!1;z.slice_from("u");break;case 4:if(!c())return!1;z.slice_from("ente");break;case 5:if(!m())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(j,4),e&&(z.bra=z.cursor,c()&&(z.slice_del(),1==e&&(z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del()))));break;case 6:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(C,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 7:if(!c())return!1;z.slice_del(),z.ket=z.cursor,e=z.find_among_b(P,3),e&&(z.bra=z.cursor,1==e&&c()&&z.slice_del());break;case 8:if(!c())return!1;z.slice_del(),z.ket=z.cursor,z.eq_s_b(2,"at")&&(z.bra=z.cursor,c()&&z.slice_del());break;case 9:if(!w()||!z.eq_s_b(1,"e"))return!1;z.slice_from("ir")}return!0}function f(){var e,r;if(z.cursor>=g){if(r=z.limit_backward,z.limit_backward=g,z.ket=z.cursor,e=z.find_among_b(S,120))return z.bra=z.cursor,1==e&&z.slice_del(),z.limit_backward=r,!0;z.limit_backward=r}return!1}function d(){var e;z.ket=z.cursor,(e=z.find_among_b(W,7))&&(z.bra=z.cursor,1==e&&w()&&z.slice_del())}function v(e,r){if(z.eq_s_b(1,e)){z.bra=z.cursor;var s=z.limit-z.cursor;if(z.eq_s_b(1,r))return z.cursor=z.limit-s,w()&&z.slice_del(),!1}return!0}function p(){var e;if(z.ket=z.cursor,e=z.find_among_b(L,4))switch(z.bra=z.cursor,e){case 1:w()&&(z.slice_del(),z.ket=z.cursor,z.limit-z.cursor,v("u","g")&&v("i","c"));break;case 2:z.slice_from("c")}}function _(){if(!l()&&(z.cursor=z.limit,!f()))return z.cursor=z.limit,void d();z.cursor=z.limit,z.ket=z.cursor,z.eq_s_b(1,"i")&&(z.bra=z.cursor,z.eq_s_b(1,"c")&&(z.cursor=z.limit,w()&&z.slice_del()))}var h,b,g,k=[new r("",-1,3),new r("ã",0,1),new r("õ",0,2)],q=[new r("",-1,3),new r("a~",0,1),new r("o~",0,2)],j=[new r("ic",-1,-1),new r("ad",-1,-1),new r("os",-1,-1),new r("iv",-1,1)],C=[new r("ante",-1,1),new r("avel",-1,1),new r("ível",-1,1)],P=[new r("ic",-1,1),new r("abil",-1,1),new r("iv",-1,1)],F=[new r("ica",-1,1),new r("ância",-1,1),new r("ência",-1,4),new r("ira",-1,9),new r("adora",-1,1),new r("osa",-1,1),new r("ista",-1,1),new r("iva",-1,8),new r("eza",-1,1),new r("logía",-1,2),new r("idade",-1,7),new r("ante",-1,1),new r("mente",-1,6),new r("amente",12,5),new r("ável",-1,1),new r("ível",-1,1),new r("ución",-1,3),new r("ico",-1,1),new r("ismo",-1,1),new r("oso",-1,1),new r("amento",-1,1),new r("imento",-1,1),new r("ivo",-1,8),new r("aça~o",-1,1),new r("ador",-1,1),new r("icas",-1,1),new r("ências",-1,4),new r("iras",-1,9),new r("adoras",-1,1),new r("osas",-1,1),new r("istas",-1,1),new r("ivas",-1,8),new r("ezas",-1,1),new r("logías",-1,2),new r("idades",-1,7),new r("uciones",-1,3),new r("adores",-1,1),new r("antes",-1,1),new r("aço~es",-1,1),new r("icos",-1,1),new r("ismos",-1,1),new r("osos",-1,1),new r("amentos",-1,1),new r("imentos",-1,1),new r("ivos",-1,8)],S=[new r("ada",-1,1),new r("ida",-1,1),new r("ia",-1,1),new r("aria",2,1),new r("eria",2,1),new r("iria",2,1),new r("ara",-1,1),new r("era",-1,1),new r("ira",-1,1),new r("ava",-1,1),new r("asse",-1,1),new r("esse",-1,1),new r("isse",-1,1),new r("aste",-1,1),new r("este",-1,1),new r("iste",-1,1),new r("ei",-1,1),new r("arei",16,1),new r("erei",16,1),new r("irei",16,1),new r("am",-1,1),new r("iam",20,1),new r("ariam",21,1),new r("eriam",21,1),new r("iriam",21,1),new r("aram",20,1),new r("eram",20,1),new r("iram",20,1),new r("avam",20,1),new r("em",-1,1),new r("arem",29,1),new r("erem",29,1),new r("irem",29,1),new r("assem",29,1),new r("essem",29,1),new r("issem",29,1),new r("ado",-1,1),new r("ido",-1,1),new r("ando",-1,1),new r("endo",-1,1),new r("indo",-1,1),new r("ara~o",-1,1),new r("era~o",-1,1),new r("ira~o",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("ir",-1,1),new r("as",-1,1),new r("adas",47,1),new r("idas",47,1),new r("ias",47,1),new r("arias",50,1),new r("erias",50,1),new r("irias",50,1),new r("aras",47,1),new r("eras",47,1),new r("iras",47,1),new r("avas",47,1),new r("es",-1,1),new r("ardes",58,1),new r("erdes",58,1),new r("irdes",58,1),new r("ares",58,1),new r("eres",58,1),new r("ires",58,1),new r("asses",58,1),new r("esses",58,1),new r("isses",58,1),new r("astes",58,1),new r("estes",58,1),new r("istes",58,1),new r("is",-1,1),new r("ais",71,1),new r("eis",71,1),new r("areis",73,1),new r("ereis",73,1),new r("ireis",73,1),new r("áreis",73,1),new r("éreis",73,1),new r("íreis",73,1),new r("ásseis",73,1),new r("ésseis",73,1),new r("ísseis",73,1),new r("áveis",73,1),new r("íeis",73,1),new r("aríeis",84,1),new r("eríeis",84,1),new r("iríeis",84,1),new r("ados",-1,1),new r("idos",-1,1),new r("amos",-1,1),new r("áramos",90,1),new r("éramos",90,1),new r("íramos",90,1),new r("ávamos",90,1),new r("íamos",90,1),new r("aríamos",95,1),new r("eríamos",95,1),new r("iríamos",95,1),new r("emos",-1,1),new r("aremos",99,1),new r("eremos",99,1),new r("iremos",99,1),new r("ássemos",99,1),new r("êssemos",99,1),new r("íssemos",99,1),new r("imos",-1,1),new r("armos",-1,1),new r("ermos",-1,1),new r("irmos",-1,1),new r("ámos",-1,1),new r("arás",-1,1),new r("erás",-1,1),new r("irás",-1,1),new r("eu",-1,1),new r("iu",-1,1),new r("ou",-1,1),new r("ará",-1,1),new r("erá",-1,1),new r("irá",-1,1)],W=[new r("a",-1,1),new r("i",-1,1),new r("o",-1,1),new r("os",-1,1),new r("á",-1,1),new r("í",-1,1),new r("ó",-1,1)],L=[new r("e",-1,1),new r("ç",-1,2),new r("é",-1,1),new r("ê",-1,1)],y=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,3,19,12,2],z=new s;this.setCurrent=function(e){z.setCurrent(e)},this.getCurrent=function(){return z.getCurrent()},this.stem=function(){var r=z.cursor;return e(),z.cursor=r,a(),z.limit_backward=r,z.cursor=z.limit,_(),z.cursor=z.limit,p(),z.cursor=z.limit_backward,u(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.pt.stemmer,"stemmer-pt"),e.pt.stopWordFilter=e.generateStopWordFilter("a ao aos aquela aquelas aquele aqueles aquilo as até com como da das de dela delas dele deles depois do dos e ela elas ele eles em entre era eram essa essas esse esses esta estamos estas estava estavam este esteja estejam estejamos estes esteve estive estivemos estiver estivera estiveram estiverem estivermos estivesse estivessem estivéramos estivéssemos estou está estávamos estão eu foi fomos for fora foram forem formos fosse fossem fui fôramos fôssemos haja hajam hajamos havemos hei houve houvemos houver houvera houveram houverei houverem houveremos houveria houveriam houvermos houverá houverão houveríamos houvesse houvessem houvéramos houvéssemos há hão isso isto já lhe lhes mais mas me mesmo meu meus minha minhas muito na nas nem no nos nossa nossas nosso nossos num numa não nós o os ou para pela pelas pelo pelos por qual quando que quem se seja sejam sejamos sem serei seremos seria seriam será serão seríamos seu seus somos sou sua suas são só também te tem temos tenha tenham tenhamos tenho terei teremos teria teriam terá terão teríamos teu teus teve tinha tinham tive tivemos tiver tivera tiveram tiverem tivermos tivesse tivessem tivéramos tivéssemos tu tua tuas tém tínhamos um uma você vocês vos à às éramos".split(" ")),e.Pipeline.registerFunction(e.pt.stopWordFilter,"stopWordFilter-pt")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ro.min.js b/assets/javascripts/lunr/min/lunr.ro.min.js new file mode 100644 index 00000000..72771401 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ro.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Romanian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ro=function(){this.pipeline.reset(),this.pipeline.add(e.ro.trimmer,e.ro.stopWordFilter,e.ro.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ro.stemmer))},e.ro.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.ro.trimmer=e.trimmerSupport.generateTrimmer(e.ro.wordCharacters),e.Pipeline.registerFunction(e.ro.trimmer,"trimmer-ro"),e.ro.stemmer=function(){var i=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,n=new function(){function e(e,i){L.eq_s(1,e)&&(L.ket=L.cursor,L.in_grouping(W,97,259)&&L.slice_from(i))}function n(){for(var i,r;;){if(i=L.cursor,L.in_grouping(W,97,259)&&(r=L.cursor,L.bra=r,e("u","U"),L.cursor=r,e("i","I")),L.cursor=i,L.cursor>=L.limit)break;L.cursor++}}function t(){if(L.out_grouping(W,97,259)){for(;!L.in_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}return!0}function a(){if(L.in_grouping(W,97,259))for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!0;L.cursor++}return!1}function o(){var e,i,r=L.cursor;if(L.in_grouping(W,97,259)){if(e=L.cursor,!t())return void(h=L.cursor);if(L.cursor=e,!a())return void(h=L.cursor)}L.cursor=r,L.out_grouping(W,97,259)&&(i=L.cursor,t()&&(L.cursor=i,L.in_grouping(W,97,259)&&L.cursor=L.limit)return!1;L.cursor++}for(;!L.out_grouping(W,97,259);){if(L.cursor>=L.limit)return!1;L.cursor++}return!0}function c(){var e=L.cursor;h=L.limit,k=h,g=h,o(),L.cursor=e,u()&&(k=L.cursor,u()&&(g=L.cursor))}function s(){for(var e;;){if(L.bra=L.cursor,e=L.find_among(z,3))switch(L.ket=L.cursor,e){case 1:L.slice_from("i");continue;case 2:L.slice_from("u");continue;case 3:if(L.cursor>=L.limit)break;L.cursor++;continue}break}}function w(){return h<=L.cursor}function m(){return k<=L.cursor}function l(){return g<=L.cursor}function f(){var e,i;if(L.ket=L.cursor,(e=L.find_among_b(C,16))&&(L.bra=L.cursor,m()))switch(e){case 1:L.slice_del();break;case 2:L.slice_from("a");break;case 3:L.slice_from("e");break;case 4:L.slice_from("i");break;case 5:i=L.limit-L.cursor,L.eq_s_b(2,"ab")||(L.cursor=L.limit-i,L.slice_from("i"));break;case 6:L.slice_from("at");break;case 7:L.slice_from("aţi")}}function p(){var e,i=L.limit-L.cursor;if(L.ket=L.cursor,(e=L.find_among_b(P,46))&&(L.bra=L.cursor,m())){switch(e){case 1:L.slice_from("abil");break;case 2:L.slice_from("ibil");break;case 3:L.slice_from("iv");break;case 4:L.slice_from("ic");break;case 5:L.slice_from("at");break;case 6:L.slice_from("it")}return _=!0,L.cursor=L.limit-i,!0}return!1}function d(){var e,i;for(_=!1;;)if(i=L.limit-L.cursor,!p()){L.cursor=L.limit-i;break}if(L.ket=L.cursor,(e=L.find_among_b(F,62))&&(L.bra=L.cursor,l())){switch(e){case 1:L.slice_del();break;case 2:L.eq_s_b(1,"ţ")&&(L.bra=L.cursor,L.slice_from("t"));break;case 3:L.slice_from("ist")}_=!0}}function b(){var e,i,r;if(L.cursor>=h){if(i=L.limit_backward,L.limit_backward=h,L.ket=L.cursor,e=L.find_among_b(q,94))switch(L.bra=L.cursor,e){case 1:if(r=L.limit-L.cursor,!L.out_grouping_b(W,97,259)&&(L.cursor=L.limit-r,!L.eq_s_b(1,"u")))break;case 2:L.slice_del()}L.limit_backward=i}}function v(){var e;L.ket=L.cursor,(e=L.find_among_b(S,5))&&(L.bra=L.cursor,w()&&1==e&&L.slice_del())}var _,g,k,h,z=[new i("",-1,3),new i("I",0,1),new i("U",0,2)],C=[new i("ea",-1,3),new i("aţia",-1,7),new i("aua",-1,2),new i("iua",-1,4),new i("aţie",-1,7),new i("ele",-1,3),new i("ile",-1,5),new i("iile",6,4),new i("iei",-1,4),new i("atei",-1,6),new i("ii",-1,4),new i("ului",-1,1),new i("ul",-1,1),new i("elor",-1,3),new i("ilor",-1,4),new i("iilor",14,4)],P=[new i("icala",-1,4),new i("iciva",-1,4),new i("ativa",-1,5),new i("itiva",-1,6),new i("icale",-1,4),new i("aţiune",-1,5),new i("iţiune",-1,6),new i("atoare",-1,5),new i("itoare",-1,6),new i("ătoare",-1,5),new i("icitate",-1,4),new i("abilitate",-1,1),new i("ibilitate",-1,2),new i("ivitate",-1,3),new i("icive",-1,4),new i("ative",-1,5),new i("itive",-1,6),new i("icali",-1,4),new i("atori",-1,5),new i("icatori",18,4),new i("itori",-1,6),new i("ători",-1,5),new i("icitati",-1,4),new i("abilitati",-1,1),new i("ivitati",-1,3),new i("icivi",-1,4),new i("ativi",-1,5),new i("itivi",-1,6),new i("icităi",-1,4),new i("abilităi",-1,1),new i("ivităi",-1,3),new i("icităţi",-1,4),new i("abilităţi",-1,1),new i("ivităţi",-1,3),new i("ical",-1,4),new i("ator",-1,5),new i("icator",35,4),new i("itor",-1,6),new i("ător",-1,5),new i("iciv",-1,4),new i("ativ",-1,5),new i("itiv",-1,6),new i("icală",-1,4),new i("icivă",-1,4),new i("ativă",-1,5),new i("itivă",-1,6)],F=[new i("ica",-1,1),new i("abila",-1,1),new i("ibila",-1,1),new i("oasa",-1,1),new i("ata",-1,1),new i("ita",-1,1),new i("anta",-1,1),new i("ista",-1,3),new i("uta",-1,1),new i("iva",-1,1),new i("ic",-1,1),new i("ice",-1,1),new i("abile",-1,1),new i("ibile",-1,1),new i("isme",-1,3),new i("iune",-1,2),new i("oase",-1,1),new i("ate",-1,1),new i("itate",17,1),new i("ite",-1,1),new i("ante",-1,1),new i("iste",-1,3),new i("ute",-1,1),new i("ive",-1,1),new i("ici",-1,1),new i("abili",-1,1),new i("ibili",-1,1),new i("iuni",-1,2),new i("atori",-1,1),new i("osi",-1,1),new i("ati",-1,1),new i("itati",30,1),new i("iti",-1,1),new i("anti",-1,1),new i("isti",-1,3),new i("uti",-1,1),new i("işti",-1,3),new i("ivi",-1,1),new i("ităi",-1,1),new i("oşi",-1,1),new i("ităţi",-1,1),new i("abil",-1,1),new i("ibil",-1,1),new i("ism",-1,3),new i("ator",-1,1),new i("os",-1,1),new i("at",-1,1),new i("it",-1,1),new i("ant",-1,1),new i("ist",-1,3),new i("ut",-1,1),new i("iv",-1,1),new i("ică",-1,1),new i("abilă",-1,1),new i("ibilă",-1,1),new i("oasă",-1,1),new i("ată",-1,1),new i("ită",-1,1),new i("antă",-1,1),new i("istă",-1,3),new i("ută",-1,1),new i("ivă",-1,1)],q=[new i("ea",-1,1),new i("ia",-1,1),new i("esc",-1,1),new i("ăsc",-1,1),new i("ind",-1,1),new i("ând",-1,1),new i("are",-1,1),new i("ere",-1,1),new i("ire",-1,1),new i("âre",-1,1),new i("se",-1,2),new i("ase",10,1),new i("sese",10,2),new i("ise",10,1),new i("use",10,1),new i("âse",10,1),new i("eşte",-1,1),new i("ăşte",-1,1),new i("eze",-1,1),new i("ai",-1,1),new i("eai",19,1),new i("iai",19,1),new i("sei",-1,2),new i("eşti",-1,1),new i("ăşti",-1,1),new i("ui",-1,1),new i("ezi",-1,1),new i("âi",-1,1),new i("aşi",-1,1),new i("seşi",-1,2),new i("aseşi",29,1),new i("seseşi",29,2),new i("iseşi",29,1),new i("useşi",29,1),new i("âseşi",29,1),new i("işi",-1,1),new i("uşi",-1,1),new i("âşi",-1,1),new i("aţi",-1,2),new i("eaţi",38,1),new i("iaţi",38,1),new i("eţi",-1,2),new i("iţi",-1,2),new i("âţi",-1,2),new i("arăţi",-1,1),new i("serăţi",-1,2),new i("aserăţi",45,1),new i("seserăţi",45,2),new i("iserăţi",45,1),new i("userăţi",45,1),new i("âserăţi",45,1),new i("irăţi",-1,1),new i("urăţi",-1,1),new i("ârăţi",-1,1),new i("am",-1,1),new i("eam",54,1),new i("iam",54,1),new i("em",-1,2),new i("asem",57,1),new i("sesem",57,2),new i("isem",57,1),new i("usem",57,1),new i("âsem",57,1),new i("im",-1,2),new i("âm",-1,2),new i("ăm",-1,2),new i("arăm",65,1),new i("serăm",65,2),new i("aserăm",67,1),new i("seserăm",67,2),new i("iserăm",67,1),new i("userăm",67,1),new i("âserăm",67,1),new i("irăm",65,1),new i("urăm",65,1),new i("ârăm",65,1),new i("au",-1,1),new i("eau",76,1),new i("iau",76,1),new i("indu",-1,1),new i("ându",-1,1),new i("ez",-1,1),new i("ească",-1,1),new i("ară",-1,1),new i("seră",-1,2),new i("aseră",84,1),new i("seseră",84,2),new i("iseră",84,1),new i("useră",84,1),new i("âseră",84,1),new i("iră",-1,1),new i("ură",-1,1),new i("âră",-1,1),new i("ează",-1,1)],S=[new i("a",-1,1),new i("e",-1,1),new i("ie",1,1),new i("i",-1,1),new i("ă",-1,1)],W=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,2,32,0,0,4],L=new r;this.setCurrent=function(e){L.setCurrent(e)},this.getCurrent=function(){return L.getCurrent()},this.stem=function(){var e=L.cursor;return n(),L.cursor=e,c(),L.limit_backward=e,L.cursor=L.limit,f(),L.cursor=L.limit,d(),L.cursor=L.limit,_||(L.cursor=L.limit,b(),L.cursor=L.limit),v(),L.cursor=L.limit_backward,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return n.setCurrent(e),n.stem(),n.getCurrent()}):(n.setCurrent(e),n.stem(),n.getCurrent())}}(),e.Pipeline.registerFunction(e.ro.stemmer,"stemmer-ro"),e.ro.stopWordFilter=e.generateStopWordFilter("acea aceasta această aceea acei aceia acel acela acele acelea acest acesta aceste acestea aceşti aceştia acolo acord acum ai aia aibă aici al ale alea altceva altcineva am ar are asemenea asta astea astăzi asupra au avea avem aveţi azi aş aşadar aţi bine bucur bună ca care caut ce cel ceva chiar cinci cine cineva contra cu cum cumva curând curînd când cât câte câtva câţi cînd cît cîte cîtva cîţi că căci cărei căror cărui către da dacă dar datorită dată dau de deci deja deoarece departe deşi din dinaintea dintr- dintre doi doilea două drept după dă ea ei el ele eram este eu eşti face fata fi fie fiecare fii fim fiu fiţi frumos fără graţie halbă iar ieri la le li lor lui lângă lîngă mai mea mei mele mereu meu mi mie mine mult multă mulţi mulţumesc mâine mîine mă ne nevoie nici nicăieri nimeni nimeri nimic nişte noastre noastră noi noroc nostru nouă noştri nu opt ori oricare orice oricine oricum oricând oricât oricînd oricît oriunde patra patru patrulea pe pentru peste pic poate pot prea prima primul prin puţin puţina puţină până pînă rog sa sale sau se spate spre sub sunt suntem sunteţi sută sînt sîntem sînteţi să săi său ta tale te timp tine toate toată tot totuşi toţi trei treia treilea tu tăi tău un una unde undeva unei uneia unele uneori unii unor unora unu unui unuia unul vi voastre voastră voi vostru vouă voştri vreme vreo vreun vă zece zero zi zice îi îl îmi împotriva în înainte înaintea încotro încât încît între întrucât întrucît îţi ăla ălea ăsta ăstea ăştia şapte şase şi ştiu ţi ţie".split(" ")),e.Pipeline.registerFunction(e.ro.stopWordFilter,"stopWordFilter-ro")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.ru.min.js b/assets/javascripts/lunr/min/lunr.ru.min.js new file mode 100644 index 00000000..186cc485 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.ru.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Russian` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,n){"function"==typeof define&&define.amd?define(n):"object"==typeof exports?module.exports=n():n()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.ru=function(){this.pipeline.reset(),this.pipeline.add(e.ru.trimmer,e.ru.stopWordFilter,e.ru.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.ru.stemmer))},e.ru.wordCharacters="Ѐ-҄҇-ԯᴫᵸⷠ-ⷿꙀ-ꚟ︮︯",e.ru.trimmer=e.trimmerSupport.generateTrimmer(e.ru.wordCharacters),e.Pipeline.registerFunction(e.ru.trimmer,"trimmer-ru"),e.ru.stemmer=function(){var n=e.stemmerSupport.Among,r=e.stemmerSupport.SnowballProgram,t=new function(){function e(){for(;!W.in_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function t(){for(;!W.out_grouping(S,1072,1103);){if(W.cursor>=W.limit)return!1;W.cursor++}return!0}function w(){b=W.limit,_=b,e()&&(b=W.cursor,t()&&e()&&t()&&(_=W.cursor))}function i(){return _<=W.cursor}function u(e,n){var r,t;if(W.ket=W.cursor,r=W.find_among_b(e,n)){switch(W.bra=W.cursor,r){case 1:if(t=W.limit-W.cursor,!W.eq_s_b(1,"а")&&(W.cursor=W.limit-t,!W.eq_s_b(1,"я")))return!1;case 2:W.slice_del()}return!0}return!1}function o(){return u(h,9)}function s(e,n){var r;return W.ket=W.cursor,!!(r=W.find_among_b(e,n))&&(W.bra=W.cursor,1==r&&W.slice_del(),!0)}function c(){return s(g,26)}function m(){return!!c()&&(u(C,8),!0)}function f(){return s(k,2)}function l(){return u(P,46)}function a(){s(v,36)}function p(){var e;W.ket=W.cursor,(e=W.find_among_b(F,2))&&(W.bra=W.cursor,i()&&1==e&&W.slice_del())}function d(){var e;if(W.ket=W.cursor,e=W.find_among_b(q,4))switch(W.bra=W.cursor,e){case 1:if(W.slice_del(),W.ket=W.cursor,!W.eq_s_b(1,"н"))break;W.bra=W.cursor;case 2:if(!W.eq_s_b(1,"н"))break;case 3:W.slice_del()}}var _,b,h=[new n("в",-1,1),new n("ив",0,2),new n("ыв",0,2),new n("вши",-1,1),new n("ивши",3,2),new n("ывши",3,2),new n("вшись",-1,1),new n("ившись",6,2),new n("ывшись",6,2)],g=[new n("ее",-1,1),new n("ие",-1,1),new n("ое",-1,1),new n("ые",-1,1),new n("ими",-1,1),new n("ыми",-1,1),new n("ей",-1,1),new n("ий",-1,1),new n("ой",-1,1),new n("ый",-1,1),new n("ем",-1,1),new n("им",-1,1),new n("ом",-1,1),new n("ым",-1,1),new n("его",-1,1),new n("ого",-1,1),new n("ему",-1,1),new n("ому",-1,1),new n("их",-1,1),new n("ых",-1,1),new n("ею",-1,1),new n("ою",-1,1),new n("ую",-1,1),new n("юю",-1,1),new n("ая",-1,1),new n("яя",-1,1)],C=[new n("ем",-1,1),new n("нн",-1,1),new n("вш",-1,1),new n("ивш",2,2),new n("ывш",2,2),new n("щ",-1,1),new n("ющ",5,1),new n("ующ",6,2)],k=[new n("сь",-1,1),new n("ся",-1,1)],P=[new n("ла",-1,1),new n("ила",0,2),new n("ыла",0,2),new n("на",-1,1),new n("ена",3,2),new n("ете",-1,1),new n("ите",-1,2),new n("йте",-1,1),new n("ейте",7,2),new n("уйте",7,2),new n("ли",-1,1),new n("или",10,2),new n("ыли",10,2),new n("й",-1,1),new n("ей",13,2),new n("уй",13,2),new n("л",-1,1),new n("ил",16,2),new n("ыл",16,2),new n("ем",-1,1),new n("им",-1,2),new n("ым",-1,2),new n("н",-1,1),new n("ен",22,2),new n("ло",-1,1),new n("ило",24,2),new n("ыло",24,2),new n("но",-1,1),new n("ено",27,2),new n("нно",27,1),new n("ет",-1,1),new n("ует",30,2),new n("ит",-1,2),new n("ыт",-1,2),new n("ют",-1,1),new n("уют",34,2),new n("ят",-1,2),new n("ны",-1,1),new n("ены",37,2),new n("ть",-1,1),new n("ить",39,2),new n("ыть",39,2),new n("ешь",-1,1),new n("ишь",-1,2),new n("ю",-1,2),new n("ую",44,2)],v=[new n("а",-1,1),new n("ев",-1,1),new n("ов",-1,1),new n("е",-1,1),new n("ие",3,1),new n("ье",3,1),new n("и",-1,1),new n("еи",6,1),new n("ии",6,1),new n("ами",6,1),new n("ями",6,1),new n("иями",10,1),new n("й",-1,1),new n("ей",12,1),new n("ией",13,1),new n("ий",12,1),new n("ой",12,1),new n("ам",-1,1),new n("ем",-1,1),new n("ием",18,1),new n("ом",-1,1),new n("ям",-1,1),new n("иям",21,1),new n("о",-1,1),new n("у",-1,1),new n("ах",-1,1),new n("ях",-1,1),new n("иях",26,1),new n("ы",-1,1),new n("ь",-1,1),new n("ю",-1,1),new n("ию",30,1),new n("ью",30,1),new n("я",-1,1),new n("ия",33,1),new n("ья",33,1)],F=[new n("ост",-1,1),new n("ость",-1,1)],q=[new n("ейше",-1,1),new n("н",-1,2),new n("ейш",-1,1),new n("ь",-1,3)],S=[33,65,8,232],W=new r;this.setCurrent=function(e){W.setCurrent(e)},this.getCurrent=function(){return W.getCurrent()},this.stem=function(){return w(),W.cursor=W.limit,!(W.cursor=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor++,!0}return!1},in_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e<=s&&e>=i&&(e-=i,t[e>>3]&1<<(7&e)))return this.cursor--,!0}return!1},out_grouping:function(t,i,s){if(this.cursors||e>3]&1<<(7&e)))return this.cursor++,!0}return!1},out_grouping_b:function(t,i,s){if(this.cursor>this.limit_backward){var e=r.charCodeAt(this.cursor-1);if(e>s||e>3]&1<<(7&e)))return this.cursor--,!0}return!1},eq_s:function(t,i){if(this.limit-this.cursor>1),f=0,l=o0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n+_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n+_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},find_among_b:function(t,i){for(var s=0,e=i,n=this.cursor,u=this.limit_backward,o=0,h=0,c=!1;;){for(var a=s+(e-s>>1),f=0,l=o=0;m--){if(n-l==u){f=-1;break}if(f=r.charCodeAt(n-1-l)-_.s[m])break;l++}if(f<0?(e=a,h=l):(s=a,o=l),e-s<=1){if(s>0||e==s||c)break;c=!0}}for(;;){var _=t[s];if(o>=_.s_size){if(this.cursor=n-_.s_size,!_.method)return _.result;var b=_.method();if(this.cursor=n-_.s_size,b)return _.result}if((s=_.substring_i)<0)return 0}},replace_s:function(t,i,s){var e=s.length-(i-t),n=r.substring(0,t),u=r.substring(i);return r=n+s+u,this.limit+=e,this.cursor>=i?this.cursor+=e:this.cursor>t&&(this.cursor=t),e},slice_check:function(){if(this.bra<0||this.bra>this.ket||this.ket>this.limit||this.limit>r.length)throw"faulty slice operation"},slice_from:function(r){this.slice_check(),this.replace_s(this.bra,this.ket,r)},slice_del:function(){this.slice_from("")},insert:function(r,t,i){var s=this.replace_s(r,t,i);r<=this.bra&&(this.bra+=s),r<=this.ket&&(this.ket+=s)},slice_to:function(){return this.slice_check(),r.substring(this.bra,this.ket)},eq_v_b:function(r){return this.eq_s_b(r.length,r)}}}},r.trimmerSupport={generateTrimmer:function(r){var t=new RegExp("^[^"+r+"]+"),i=new RegExp("[^"+r+"]+$");return function(r){return"function"==typeof r.update?r.update(function(r){return r.replace(t,"").replace(i,"")}):r.replace(t,"").replace(i,"")}}}}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.sv.min.js b/assets/javascripts/lunr/min/lunr.sv.min.js new file mode 100644 index 00000000..3e5eb640 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.sv.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Swedish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.sv=function(){this.pipeline.reset(),this.pipeline.add(e.sv.trimmer,e.sv.stopWordFilter,e.sv.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(e.sv.stemmer))},e.sv.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",e.sv.trimmer=e.trimmerSupport.generateTrimmer(e.sv.wordCharacters),e.Pipeline.registerFunction(e.sv.trimmer,"trimmer-sv"),e.sv.stemmer=function(){var r=e.stemmerSupport.Among,n=e.stemmerSupport.SnowballProgram,t=new function(){function e(){var e,r=w.cursor+3;if(o=w.limit,0<=r||r<=w.limit){for(a=r;;){if(e=w.cursor,w.in_grouping(l,97,246)){w.cursor=e;break}if(w.cursor=e,w.cursor>=w.limit)return;w.cursor++}for(;!w.out_grouping(l,97,246);){if(w.cursor>=w.limit)return;w.cursor++}o=w.cursor,o=o&&(w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(u,37),w.limit_backward=r,e))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.in_grouping_b(d,98,121)&&w.slice_del()}}function i(){var e=w.limit_backward;w.cursor>=o&&(w.limit_backward=o,w.cursor=w.limit,w.find_among_b(c,7)&&(w.cursor=w.limit,w.ket=w.cursor,w.cursor>w.limit_backward&&(w.bra=--w.cursor,w.slice_del())),w.limit_backward=e)}function s(){var e,r;if(w.cursor>=o){if(r=w.limit_backward,w.limit_backward=o,w.cursor=w.limit,w.ket=w.cursor,e=w.find_among_b(m,5))switch(w.bra=w.cursor,e){case 1:w.slice_del();break;case 2:w.slice_from("lös");break;case 3:w.slice_from("full")}w.limit_backward=r}}var a,o,u=[new r("a",-1,1),new r("arna",0,1),new r("erna",0,1),new r("heterna",2,1),new r("orna",0,1),new r("ad",-1,1),new r("e",-1,1),new r("ade",6,1),new r("ande",6,1),new r("arne",6,1),new r("are",6,1),new r("aste",6,1),new r("en",-1,1),new r("anden",12,1),new r("aren",12,1),new r("heten",12,1),new r("ern",-1,1),new r("ar",-1,1),new r("er",-1,1),new r("heter",18,1),new r("or",-1,1),new r("s",-1,2),new r("as",21,1),new r("arnas",22,1),new r("ernas",22,1),new r("ornas",22,1),new r("es",21,1),new r("ades",26,1),new r("andes",26,1),new r("ens",21,1),new r("arens",29,1),new r("hetens",29,1),new r("erns",21,1),new r("at",-1,1),new r("andet",-1,1),new r("het",-1,1),new r("ast",-1,1)],c=[new r("dd",-1,-1),new r("gd",-1,-1),new r("nn",-1,-1),new r("dt",-1,-1),new r("gt",-1,-1),new r("kt",-1,-1),new r("tt",-1,-1)],m=[new r("ig",-1,1),new r("lig",0,1),new r("els",-1,1),new r("fullt",-1,3),new r("löst",-1,2)],l=[17,65,16,1,0,0,0,0,0,0,0,0,0,0,0,0,24,0,32],d=[119,127,149],w=new n;this.setCurrent=function(e){w.setCurrent(e)},this.getCurrent=function(){return w.getCurrent()},this.stem=function(){var r=w.cursor;return e(),w.limit_backward=r,w.cursor=w.limit,t(),w.cursor=w.limit,i(),w.cursor=w.limit,s(),!0}};return function(e){return"function"==typeof e.update?e.update(function(e){return t.setCurrent(e),t.stem(),t.getCurrent()}):(t.setCurrent(e),t.stem(),t.getCurrent())}}(),e.Pipeline.registerFunction(e.sv.stemmer,"stemmer-sv"),e.sv.stopWordFilter=e.generateStopWordFilter("alla allt att av blev bli blir blivit de dem den denna deras dess dessa det detta dig din dina ditt du där då efter ej eller en er era ert ett från för ha hade han hans har henne hennes hon honom hur här i icke ingen inom inte jag ju kan kunde man med mellan men mig min mina mitt mot mycket ni nu när någon något några och om oss på samma sedan sig sin sina sitta själv skulle som så sådan sådana sådant till under upp ut utan vad var vara varför varit varje vars vart vem vi vid vilka vilkas vilken vilket vår våra vårt än är åt över".split(" ")),e.Pipeline.registerFunction(e.sv.stopWordFilter,"stopWordFilter-sv")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.th.min.js b/assets/javascripts/lunr/min/lunr.th.min.js new file mode 100644 index 00000000..dee3aac6 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.th.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var r="2"==e.version[0];e.th=function(){this.pipeline.reset(),this.pipeline.add(e.th.trimmer),r?this.tokenizer=e.th.tokenizer:(e.tokenizer&&(e.tokenizer=e.th.tokenizer),this.tokenizerFn&&(this.tokenizerFn=e.th.tokenizer))},e.th.wordCharacters="[฀-๿]",e.th.trimmer=e.trimmerSupport.generateTrimmer(e.th.wordCharacters),e.Pipeline.registerFunction(e.th.trimmer,"trimmer-th");var t=e.wordcut;t.init(),e.th.tokenizer=function(i){if(!arguments.length||null==i||void 0==i)return[];if(Array.isArray(i))return i.map(function(t){return r?new e.Token(t):t});var n=i.toString().replace(/^\s+/,"");return t.cut(n).split("|")}}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.tr.min.js b/assets/javascripts/lunr/min/lunr.tr.min.js new file mode 100644 index 00000000..563f6ec1 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.tr.min.js @@ -0,0 +1,18 @@ +/*! + * Lunr languages, `Turkish` language + * https://github.com/MihaiValentin/lunr-languages + * + * Copyright 2014, Mihai Valentin + * http://www.mozilla.org/MPL/ + */ +/*! + * based on + * Snowball JavaScript Library v0.3 + * http://code.google.com/p/urim/ + * http://snowball.tartarus.org/ + * + * Copyright 2010, Oleg Mazko + * http://www.mozilla.org/MPL/ + */ + +!function(r,i){"function"==typeof define&&define.amd?define(i):"object"==typeof exports?module.exports=i():i()(r.lunr)}(this,function(){return function(r){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");r.tr=function(){this.pipeline.reset(),this.pipeline.add(r.tr.trimmer,r.tr.stopWordFilter,r.tr.stemmer),this.searchPipeline&&(this.searchPipeline.reset(),this.searchPipeline.add(r.tr.stemmer))},r.tr.wordCharacters="A-Za-zªºÀ-ÖØ-öø-ʸˠ-ˤᴀ-ᴥᴬ-ᵜᵢ-ᵥᵫ-ᵷᵹ-ᶾḀ-ỿⁱⁿₐ-ₜKÅℲⅎⅠ-ↈⱠ-ⱿꜢ-ꞇꞋ-ꞭꞰ-ꞷꟷ-ꟿꬰ-ꭚꭜ-ꭤff-stＡ-Ｚａ-ｚ",r.tr.trimmer=r.trimmerSupport.generateTrimmer(r.tr.wordCharacters),r.Pipeline.registerFunction(r.tr.trimmer,"trimmer-tr"),r.tr.stemmer=function(){var i=r.stemmerSupport.Among,e=r.stemmerSupport.SnowballProgram,n=new function(){function r(r,i,e){for(;;){var n=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(r,i,e)){Dr.cursor=Dr.limit-n;break}if(Dr.cursor=Dr.limit-n,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function n(){var i,e;i=Dr.limit-Dr.cursor,r(Wr,97,305);for(var n=0;nDr.limit_backward&&(Dr.cursor--,e=Dr.limit-Dr.cursor,i()))?(Dr.cursor=Dr.limit-e,!0):(Dr.cursor=Dr.limit-n,r()?(Dr.cursor=Dr.limit-n,!1):(Dr.cursor=Dr.limit-n,!(Dr.cursor<=Dr.limit_backward)&&(Dr.cursor--,!!i()&&(Dr.cursor=Dr.limit-n,!0))))}function u(r){return t(r,function(){return Dr.in_grouping_b(Wr,97,305)})}function o(){return u(function(){return Dr.eq_s_b(1,"n")})}function s(){return u(function(){return Dr.eq_s_b(1,"s")})}function c(){return u(function(){return Dr.eq_s_b(1,"y")})}function l(){return t(function(){return Dr.in_grouping_b(Lr,105,305)},function(){return Dr.out_grouping_b(Wr,97,305)})}function a(){return Dr.find_among_b(ur,10)&&l()}function m(){return n()&&Dr.in_grouping_b(Lr,105,305)&&s()}function d(){return Dr.find_among_b(or,2)}function f(){return n()&&Dr.in_grouping_b(Lr,105,305)&&c()}function b(){return n()&&Dr.find_among_b(sr,4)}function w(){return n()&&Dr.find_among_b(cr,4)&&o()}function _(){return n()&&Dr.find_among_b(lr,2)&&c()}function k(){return n()&&Dr.find_among_b(ar,2)}function p(){return n()&&Dr.find_among_b(mr,4)}function g(){return n()&&Dr.find_among_b(dr,2)}function y(){return n()&&Dr.find_among_b(fr,4)}function z(){return n()&&Dr.find_among_b(br,2)}function v(){return n()&&Dr.find_among_b(wr,2)&&c()}function h(){return Dr.eq_s_b(2,"ki")}function q(){return n()&&Dr.find_among_b(_r,2)&&o()}function C(){return n()&&Dr.find_among_b(kr,4)&&c()}function P(){return n()&&Dr.find_among_b(pr,4)}function F(){return n()&&Dr.find_among_b(gr,4)&&c()}function S(){return Dr.find_among_b(yr,4)}function W(){return n()&&Dr.find_among_b(zr,2)}function L(){return n()&&Dr.find_among_b(vr,4)}function x(){return n()&&Dr.find_among_b(hr,8)}function A(){return Dr.find_among_b(qr,2)}function E(){return n()&&Dr.find_among_b(Cr,32)&&c()}function j(){return Dr.find_among_b(Pr,8)&&c()}function T(){return n()&&Dr.find_among_b(Fr,4)&&c()}function Z(){return Dr.eq_s_b(3,"ken")&&c()}function B(){var r=Dr.limit-Dr.cursor;return!(T()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,Z()))))}function D(){if(A()){var r=Dr.limit-Dr.cursor;if(S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T())return!1}return!0}function G(){if(W()){Dr.bra=Dr.cursor,Dr.slice_del();var r=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,x()||(Dr.cursor=Dr.limit-r,E()||(Dr.cursor=Dr.limit-r,j()||(Dr.cursor=Dr.limit-r,T()||(Dr.cursor=Dr.limit-r)))),nr=!1,!1}return!0}function H(){if(!L())return!0;var r=Dr.limit-Dr.cursor;return!E()&&(Dr.cursor=Dr.limit-r,!j())}function I(){var r,i=Dr.limit-Dr.cursor;return!(S()||(Dr.cursor=Dr.limit-i,F()||(Dr.cursor=Dr.limit-i,P()||(Dr.cursor=Dr.limit-i,C()))))||(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,T()||(Dr.cursor=Dr.limit-r),!1)}function J(){var r,i=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,nr=!0,B()&&(Dr.cursor=Dr.limit-i,D()&&(Dr.cursor=Dr.limit-i,G()&&(Dr.cursor=Dr.limit-i,H()&&(Dr.cursor=Dr.limit-i,I()))))){if(Dr.cursor=Dr.limit-i,!x())return;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,S()||(Dr.cursor=Dr.limit-r,W()||(Dr.cursor=Dr.limit-r,C()||(Dr.cursor=Dr.limit-r,P()||(Dr.cursor=Dr.limit-r,F()||(Dr.cursor=Dr.limit-r))))),T()||(Dr.cursor=Dr.limit-r)}Dr.bra=Dr.cursor,Dr.slice_del()}function K(){var r,i,e,n;if(Dr.ket=Dr.cursor,h()){if(r=Dr.limit-Dr.cursor,p())return Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,a()&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))),!0;if(Dr.cursor=Dr.limit-r,w()){if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,e=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-e,!m()&&(Dr.cursor=Dr.limit-e,!K())))return!0;Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}return!0}if(Dr.cursor=Dr.limit-r,g()){if(n=Dr.limit-Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-n,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-n,!K())return!1;return!0}}return!1}function M(r){if(Dr.ket=Dr.cursor,!g()&&(Dr.cursor=Dr.limit-r,!k()))return!1;var i=Dr.limit-Dr.cursor;if(d())Dr.bra=Dr.cursor,Dr.slice_del();else if(Dr.cursor=Dr.limit-i,m())Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K());else if(Dr.cursor=Dr.limit-i,!K())return!1;return!0}function N(r){if(Dr.ket=Dr.cursor,!z()&&(Dr.cursor=Dr.limit-r,!b()))return!1;var i=Dr.limit-Dr.cursor;return!(!m()&&(Dr.cursor=Dr.limit-i,!d()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)}function O(){var r,i=Dr.limit-Dr.cursor;return Dr.ket=Dr.cursor,!(!w()&&(Dr.cursor=Dr.limit-i,!v()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,!(!W()||(Dr.bra=Dr.cursor,Dr.slice_del(),!K()))||(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!(a()||(Dr.cursor=Dr.limit-r,m()||(Dr.cursor=Dr.limit-r,K())))||(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()),!0)))}function Q(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,!p()&&(Dr.cursor=Dr.limit-e,!f()&&(Dr.cursor=Dr.limit-e,!_())))return!1;if(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,r=Dr.limit-Dr.cursor,a())Dr.bra=Dr.cursor,Dr.slice_del(),i=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,W()||(Dr.cursor=Dr.limit-i);else if(Dr.cursor=Dr.limit-r,!W())return!0;return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,K(),!0}function R(){var r,i,e=Dr.limit-Dr.cursor;if(Dr.ket=Dr.cursor,W())return Dr.bra=Dr.cursor,Dr.slice_del(),void K();if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,q())if(Dr.bra=Dr.cursor,Dr.slice_del(),r=Dr.limit-Dr.cursor,Dr.ket=Dr.cursor,d())Dr.bra=Dr.cursor,Dr.slice_del();else{if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!a()&&(Dr.cursor=Dr.limit-r,!m())){if(Dr.cursor=Dr.limit-r,Dr.ket=Dr.cursor,!W())return;if(Dr.bra=Dr.cursor,Dr.slice_del(),!K())return}Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())}else if(Dr.cursor=Dr.limit-e,!M(e)&&(Dr.cursor=Dr.limit-e,!N(e))){if(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,y())return Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,i=Dr.limit-Dr.cursor,void(a()?(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K())):(Dr.cursor=Dr.limit-i,W()?(Dr.bra=Dr.cursor,Dr.slice_del(),K()):(Dr.cursor=Dr.limit-i,K())));if(Dr.cursor=Dr.limit-e,!O()){if(Dr.cursor=Dr.limit-e,d())return Dr.bra=Dr.cursor,void Dr.slice_del();Dr.cursor=Dr.limit-e,K()||(Dr.cursor=Dr.limit-e,Q()||(Dr.cursor=Dr.limit-e,Dr.ket=Dr.cursor,(a()||(Dr.cursor=Dr.limit-e,m()))&&(Dr.bra=Dr.cursor,Dr.slice_del(),Dr.ket=Dr.cursor,W()&&(Dr.bra=Dr.cursor,Dr.slice_del(),K()))))}}}function U(){var r;if(Dr.ket=Dr.cursor,r=Dr.find_among_b(Sr,4))switch(Dr.bra=Dr.cursor,r){case 1:Dr.slice_from("p");break;case 2:Dr.slice_from("ç");break;case 3:Dr.slice_from("t");break;case 4:Dr.slice_from("k")}}function V(){for(;;){var r=Dr.limit-Dr.cursor;if(Dr.in_grouping_b(Wr,97,305)){Dr.cursor=Dr.limit-r;break}if(Dr.cursor=Dr.limit-r,Dr.cursor<=Dr.limit_backward)return!1;Dr.cursor--}return!0}function X(r,i,e){if(Dr.cursor=Dr.limit-r,V()){var n=Dr.limit-Dr.cursor;if(!Dr.eq_s_b(1,i)&&(Dr.cursor=Dr.limit-n,!Dr.eq_s_b(1,e)))return!0;Dr.cursor=Dr.limit-r;var t=Dr.cursor;return Dr.insert(Dr.cursor,Dr.cursor,e),Dr.cursor=t,!1}return!0}function Y(){var r=Dr.limit-Dr.cursor;(Dr.eq_s_b(1,"d")||(Dr.cursor=Dr.limit-r,Dr.eq_s_b(1,"g")))&&X(r,"a","ı")&&X(r,"e","i")&&X(r,"o","u")&&X(r,"ö","ü")}function $(){for(var r,i=Dr.cursor,e=2;;){for(r=Dr.cursor;!Dr.in_grouping(Wr,97,305);){if(Dr.cursor>=Dr.limit)return Dr.cursor=r,!(e>0)&&(Dr.cursor=i,!0);Dr.cursor++}e--}}function rr(r,i,e){for(;!Dr.eq_s(i,e);){if(Dr.cursor>=Dr.limit)return!0;Dr.cursor++}return(tr=i)!=Dr.limit||(Dr.cursor=r,!1)}function ir(){var r=Dr.cursor;return!rr(r,2,"ad")||(Dr.cursor=r,!rr(r,5,"soyad"))}function er(){var r=Dr.cursor;return!ir()&&(Dr.limit_backward=r,Dr.cursor=Dr.limit,Y(),Dr.cursor=Dr.limit,U(),!0)}var nr,tr,ur=[new i("m",-1,-1),new i("n",-1,-1),new i("miz",-1,-1),new i("niz",-1,-1),new i("muz",-1,-1),new i("nuz",-1,-1),new i("müz",-1,-1),new i("nüz",-1,-1),new i("mız",-1,-1),new i("nız",-1,-1)],or=[new i("leri",-1,-1),new i("ları",-1,-1)],sr=[new i("ni",-1,-1),new i("nu",-1,-1),new i("nü",-1,-1),new i("nı",-1,-1)],cr=[new i("in",-1,-1),new i("un",-1,-1),new i("ün",-1,-1),new i("ın",-1,-1)],lr=[new i("a",-1,-1),new i("e",-1,-1)],ar=[new i("na",-1,-1),new i("ne",-1,-1)],mr=[new i("da",-1,-1),new i("ta",-1,-1),new i("de",-1,-1),new i("te",-1,-1)],dr=[new i("nda",-1,-1),new i("nde",-1,-1)],fr=[new i("dan",-1,-1),new i("tan",-1,-1),new i("den",-1,-1),new i("ten",-1,-1)],br=[new i("ndan",-1,-1),new i("nden",-1,-1)],wr=[new i("la",-1,-1),new i("le",-1,-1)],_r=[new i("ca",-1,-1),new i("ce",-1,-1)],kr=[new i("im",-1,-1),new i("um",-1,-1),new i("üm",-1,-1),new i("ım",-1,-1)],pr=[new i("sin",-1,-1),new i("sun",-1,-1),new i("sün",-1,-1),new i("sın",-1,-1)],gr=[new i("iz",-1,-1),new i("uz",-1,-1),new i("üz",-1,-1),new i("ız",-1,-1)],yr=[new i("siniz",-1,-1),new i("sunuz",-1,-1),new i("sünüz",-1,-1),new i("sınız",-1,-1)],zr=[new i("lar",-1,-1),new i("ler",-1,-1)],vr=[new i("niz",-1,-1),new i("nuz",-1,-1),new i("nüz",-1,-1),new i("nız",-1,-1)],hr=[new i("dir",-1,-1),new i("tir",-1,-1),new i("dur",-1,-1),new i("tur",-1,-1),new i("dür",-1,-1),new i("tür",-1,-1),new i("dır",-1,-1),new i("tır",-1,-1)],qr=[new i("casına",-1,-1),new i("cesine",-1,-1)],Cr=[new i("di",-1,-1),new i("ti",-1,-1),new i("dik",-1,-1),new i("tik",-1,-1),new i("duk",-1,-1),new i("tuk",-1,-1),new i("dük",-1,-1),new i("tük",-1,-1),new i("dık",-1,-1),new i("tık",-1,-1),new i("dim",-1,-1),new i("tim",-1,-1),new i("dum",-1,-1),new i("tum",-1,-1),new i("düm",-1,-1),new i("tüm",-1,-1),new i("dım",-1,-1),new i("tım",-1,-1),new i("din",-1,-1),new i("tin",-1,-1),new i("dun",-1,-1),new i("tun",-1,-1),new i("dün",-1,-1),new i("tün",-1,-1),new i("dın",-1,-1),new i("tın",-1,-1),new i("du",-1,-1),new i("tu",-1,-1),new i("dü",-1,-1),new i("tü",-1,-1),new i("dı",-1,-1),new i("tı",-1,-1)],Pr=[new i("sa",-1,-1),new i("se",-1,-1),new i("sak",-1,-1),new i("sek",-1,-1),new i("sam",-1,-1),new i("sem",-1,-1),new i("san",-1,-1),new i("sen",-1,-1)],Fr=[new i("miş",-1,-1),new i("muş",-1,-1),new i("müş",-1,-1),new i("mış",-1,-1)],Sr=[new i("b",-1,1),new i("c",-1,2),new i("d",-1,3),new i("ğ",-1,4)],Wr=[17,65,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,32,8,0,0,0,0,0,0,1],Lr=[1,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,8,0,0,0,0,0,0,1],xr=[1,64,16,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],Ar=[17,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,130],Er=[1,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,1],jr=[17],Tr=[65],Zr=[65],Br=[["a",xr,97,305],["e",Ar,101,252],["ı",Er,97,305],["i",jr,101,105],["o",Tr,111,117],["ö",Zr,246,252],["u",Tr,111,117]],Dr=new e;this.setCurrent=function(r){Dr.setCurrent(r)},this.getCurrent=function(){return Dr.getCurrent()},this.stem=function(){return!!($()&&(Dr.limit_backward=Dr.cursor,Dr.cursor=Dr.limit,J(),Dr.cursor=Dr.limit,nr&&(R(),Dr.cursor=Dr.limit_backward,er())))}};return function(r){return"function"==typeof r.update?r.update(function(r){return n.setCurrent(r),n.stem(),n.getCurrent()}):(n.setCurrent(r),n.stem(),n.getCurrent())}}(),r.Pipeline.registerFunction(r.tr.stemmer,"stemmer-tr"),r.tr.stopWordFilter=r.generateStopWordFilter("acaba altmış altı ama ancak arada aslında ayrıca bana bazı belki ben benden beni benim beri beş bile bin bir biri birkaç birkez birçok birşey birşeyi biz bizden bize bizi bizim bu buna bunda bundan bunlar bunları bunların bunu bunun burada böyle böylece da daha dahi de defa değil diye diğer doksan dokuz dolayı dolayısıyla dört edecek eden ederek edilecek ediliyor edilmesi ediyor elli en etmesi etti ettiği ettiğini eğer gibi göre halen hangi hatta hem henüz hep hepsi her herhangi herkesin hiç hiçbir iki ile ilgili ise itibaren itibariyle için işte kadar karşın katrilyon kendi kendilerine kendini kendisi kendisine kendisini kez ki kim kimden kime kimi kimse kırk milyar milyon mu mü mı nasıl ne neden nedenle nerde nerede nereye niye niçin o olan olarak oldu olduklarını olduğu olduğunu olmadı olmadığı olmak olması olmayan olmaz olsa olsun olup olur olursa oluyor on ona ondan onlar onlardan onları onların onu onun otuz oysa pek rağmen sadece sanki sekiz seksen sen senden seni senin siz sizden sizi sizin tarafından trilyon tüm var vardı ve veya ya yani yapacak yapmak yaptı yaptıkları yaptığı yaptığını yapılan yapılması yapıyor yedi yerine yetmiş yine yirmi yoksa yüz zaten çok çünkü öyle üzere üç şey şeyden şeyi şeyler şu şuna şunda şundan şunları şunu şöyle".split(" ")),r.Pipeline.registerFunction(r.tr.stopWordFilter,"stopWordFilter-tr")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.vi.min.js b/assets/javascripts/lunr/min/lunr.vi.min.js new file mode 100644 index 00000000..22aed28c --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.vi.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r():r()(e.lunr)}(this,function(){return function(e){if(void 0===e)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===e.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");e.vi=function(){this.pipeline.reset(),this.pipeline.add(e.vi.stopWordFilter,e.vi.trimmer)},e.vi.wordCharacters="[A-Za-ẓ̀͐́͑̉̃̓ÂâÊêÔôĂ-ăĐ-đƠ-ơƯ-ư]",e.vi.trimmer=e.trimmerSupport.generateTrimmer(e.vi.wordCharacters),e.Pipeline.registerFunction(e.vi.trimmer,"trimmer-vi"),e.vi.stopWordFilter=e.generateStopWordFilter("là cái nhưng mà".split(" "))}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/min/lunr.zh.min.js b/assets/javascripts/lunr/min/lunr.zh.min.js new file mode 100644 index 00000000..7727bbe2 --- /dev/null +++ b/assets/javascripts/lunr/min/lunr.zh.min.js @@ -0,0 +1 @@ +!function(e,r){"function"==typeof define&&define.amd?define(r):"object"==typeof exports?module.exports=r(require("nodejieba")):r()(e.lunr)}(this,function(e){return function(r,t){if(void 0===r)throw new Error("Lunr is not present. Please include / require Lunr before this script.");if(void 0===r.stemmerSupport)throw new Error("Lunr stemmer support is not present. Please include / require Lunr stemmer support before this script.");var i="2"==r.version[0];r.zh=function(){this.pipeline.reset(),this.pipeline.add(r.zh.trimmer,r.zh.stopWordFilter,r.zh.stemmer),i?this.tokenizer=r.zh.tokenizer:(r.tokenizer&&(r.tokenizer=r.zh.tokenizer),this.tokenizerFn&&(this.tokenizerFn=r.zh.tokenizer))},r.zh.tokenizer=function(n){if(!arguments.length||null==n||void 0==n)return[];if(Array.isArray(n))return n.map(function(e){return i?new r.Token(e.toLowerCase()):e.toLowerCase()});t&&e.load(t);var o=n.toString().trim().toLowerCase(),s=[];e.cut(o,!0).forEach(function(e){s=s.concat(e.split(" "))}),s=s.filter(function(e){return!!e});var u=0;return s.map(function(e,t){if(i){var n=o.indexOf(e,u),s={};return s.position=[n,e.length],s.index=t,u=n,new r.Token(e,s)}return e})},r.zh.wordCharacters="\\w一-龥",r.zh.trimmer=r.trimmerSupport.generateTrimmer(r.zh.wordCharacters),r.Pipeline.registerFunction(r.zh.trimmer,"trimmer-zh"),r.zh.stemmer=function(){return function(e){return e}}(),r.Pipeline.registerFunction(r.zh.stemmer,"stemmer-zh"),r.zh.stopWordFilter=r.generateStopWordFilter("的 一 不 在 人 有 是 为 以 于 上 他 而 后 之 来 及 了 因 下 可 到 由 这 与 也 此 但 并 个 其 已 无 小 我 们 起 最 再 今 去 好 只 又 或 很 亦 某 把 那 你 乃 它 吧 被 比 别 趁 当 从 到 得 打 凡 儿 尔 该 各 给 跟 和 何 还 即 几 既 看 据 距 靠 啦 了 另 么 每 们 嘛 拿 哪 那 您 凭 且 却 让 仍 啥 如 若 使 谁 虽 随 同 所 她 哇 嗡 往 哪 些 向 沿 哟 用 于 咱 则 怎 曾 至 致 着 诸 自".split(" ")),r.Pipeline.registerFunction(r.zh.stopWordFilter,"stopWordFilter-zh")}}); \ No newline at end of file diff --git a/assets/javascripts/lunr/tinyseg.js b/assets/javascripts/lunr/tinyseg.js new file mode 100644 index 00000000..167fa6dd --- /dev/null +++ b/assets/javascripts/lunr/tinyseg.js @@ -0,0 +1,206 @@ +/** + * export the module via AMD, CommonJS or as a browser global + * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js + */ +;(function (root, factory) { + if (typeof define === 'function' && define.amd) { + // AMD. Register as an anonymous module. + define(factory) + } else if (typeof exports === 'object') { + /** + * Node. Does not work with strict CommonJS, but + * only CommonJS-like environments that support module.exports, + * like Node. + */ + module.exports = factory() + } else { + // Browser globals (root is window) + factory()(root.lunr); + } +}(this, function () { + /** + * Just return a value to define the module export. + * This example returns an object, but the module + * can return a function as the exported value. + */ + + return function(lunr) { + // TinySegmenter 0.1 -- Super compact Japanese tokenizer in Javascript + // (c) 2008 Taku Kudo + // TinySegmenter is freely distributable under the terms of a new BSD licence. + // For details, see http://chasen.org/~taku/software/TinySegmenter/LICENCE.txt + + function TinySegmenter() { + var patterns = { + "[一二三四五六七八九十百千万億兆]":"M", + "[一-龠々〆ヵヶ]":"H", + "[ぁ-ん]":"I", + "[ァ-ヴーｱ-ﾝﾞｰ]":"K", + "[a-zA-Zａ-ｚＡ-Ｚ]":"A", + "[0-9０-９]":"N" + } + this.chartype_ = []; + for (var i in patterns) { + var regexp = new RegExp(i); + this.chartype_.push([regexp, patterns[i]]); + } + + this.BIAS__ = -332 + this.BC1__ = {"HH":6,"II":2461,"KH":406,"OH":-1378}; + this.BC2__ = {"AA":-3267,"AI":2744,"AN":-878,"HH":-4070,"HM":-1711,"HN":4012,"HO":3761,"IA":1327,"IH":-1184,"II":-1332,"IK":1721,"IO":5492,"KI":3831,"KK":-8741,"MH":-3132,"MK":3334,"OO":-2920}; + this.BC3__ = {"HH":996,"HI":626,"HK":-721,"HN":-1307,"HO":-836,"IH":-301,"KK":2762,"MK":1079,"MM":4034,"OA":-1652,"OH":266}; + this.BP1__ = {"BB":295,"OB":304,"OO":-125,"UB":352}; + this.BP2__ = {"BO":60,"OO":-1762}; + this.BQ1__ = {"BHH":1150,"BHM":1521,"BII":-1158,"BIM":886,"BMH":1208,"BNH":449,"BOH":-91,"BOO":-2597,"OHI":451,"OIH":-296,"OKA":1851,"OKH":-1020,"OKK":904,"OOO":2965}; + this.BQ2__ = {"BHH":118,"BHI":-1159,"BHM":466,"BIH":-919,"BKK":-1720,"BKO":864,"OHH":-1139,"OHM":-181,"OIH":153,"UHI":-1146}; + this.BQ3__ = {"BHH":-792,"BHI":2664,"BII":-299,"BKI":419,"BMH":937,"BMM":8335,"BNN":998,"BOH":775,"OHH":2174,"OHM":439,"OII":280,"OKH":1798,"OKI":-793,"OKO":-2242,"OMH":-2402,"OOO":11699}; + this.BQ4__ = {"BHH":-3895,"BIH":3761,"BII":-4654,"BIK":1348,"BKK":-1806,"BMI":-3385,"BOO":-12396,"OAH":926,"OHH":266,"OHK":-2036,"ONN":-973}; + this.BW1__ = {",と":660,",同":727,"B1あ":1404,"B1同":542,"、と":660,"、同":727,"」と":1682,"あっ":1505,"いう":1743,"いっ":-2055,"いる":672,"うし":-4817,"うん":665,"から":3472,"がら":600,"こう":-790,"こと":2083,"こん":-1262,"さら":-4143,"さん":4573,"した":2641,"して":1104,"すで":-3399,"そこ":1977,"それ":-871,"たち":1122,"ため":601,"った":3463,"つい":-802,"てい":805,"てき":1249,"でき":1127,"です":3445,"では":844,"とい":-4915,"とみ":1922,"どこ":3887,"ない":5713,"なっ":3015,"など":7379,"なん":-1113,"にし":2468,"には":1498,"にも":1671,"に対":-912,"の一":-501,"の中":741,"ませ":2448,"まで":1711,"まま":2600,"まる":-2155,"やむ":-1947,"よっ":-2565,"れた":2369,"れで":-913,"をし":1860,"を見":731,"亡く":-1886,"京都":2558,"取り":-2784,"大き":-2604,"大阪":1497,"平方":-2314,"引き":-1336,"日本":-195,"本当":-2423,"毎日":-2113,"目指":-724,"Ｂ１あ":1404,"Ｂ１同":542,"｣と":1682}; + this.BW2__ = {"..":-11822,"11":-669,"――":-5730,"−−":-13175,"いう":-1609,"うか":2490,"かし":-1350,"かも":-602,"から":-7194,"かれ":4612,"がい":853,"がら":-3198,"きた":1941,"くな":-1597,"こと":-8392,"この":-4193,"させ":4533,"され":13168,"さん":-3977,"しい":-1819,"しか":-545,"した":5078,"して":972,"しな":939,"その":-3744,"たい":-1253,"たた":-662,"ただ":-3857,"たち":-786,"たと":1224,"たは":-939,"った":4589,"って":1647,"っと":-2094,"てい":6144,"てき":3640,"てく":2551,"ては":-3110,"ても":-3065,"でい":2666,"でき":-1528,"でし":-3828,"です":-4761,"でも":-4203,"とい":1890,"とこ":-1746,"とと":-2279,"との":720,"とみ":5168,"とも":-3941,"ない":-2488,"なが":-1313,"など":-6509,"なの":2614,"なん":3099,"にお":-1615,"にし":2748,"にな":2454,"によ":-7236,"に対":-14943,"に従":-4688,"に関":-11388,"のか":2093,"ので":-7059,"のに":-6041,"のの":-6125,"はい":1073,"はが":-1033,"はず":-2532,"ばれ":1813,"まし":-1316,"まで":-6621,"まれ":5409,"めて":-3153,"もい":2230,"もの":-10713,"らか":-944,"らし":-1611,"らに":-1897,"りし":651,"りま":1620,"れた":4270,"れて":849,"れば":4114,"ろう":6067,"われ":7901,"を通":-11877,"んだ":728,"んな":-4115,"一人":602,"一方":-1375,"一日":970,"一部":-1051,"上が":-4479,"会社":-1116,"出て":2163,"分の":-7758,"同党":970,"同日":-913,"大阪":-2471,"委員":-1250,"少な":-1050,"年度":-8669,"年間":-1626,"府県":-2363,"手権":-1982,"新聞":-4066,"日新":-722,"日本":-7068,"日米":3372,"曜日":-601,"朝鮮":-2355,"本人":-2697,"東京":-1543,"然と":-1384,"社会":-1276,"立て":-990,"第に":-1612,"米国":-4268,"１１":-669}; + this.BW3__ = {"あた":-2194,"あり":719,"ある":3846,"い.":-1185,"い。":-1185,"いい":5308,"いえ":2079,"いく":3029,"いた":2056,"いっ":1883,"いる":5600,"いわ":1527,"うち":1117,"うと":4798,"えと":1454,"か.":2857,"か。":2857,"かけ":-743,"かっ":-4098,"かに":-669,"から":6520,"かり":-2670,"が,":1816,"が、":1816,"がき":-4855,"がけ":-1127,"がっ":-913,"がら":-4977,"がり":-2064,"きた":1645,"けど":1374,"こと":7397,"この":1542,"ころ":-2757,"さい":-714,"さを":976,"し,":1557,"し、":1557,"しい":-3714,"した":3562,"して":1449,"しな":2608,"しま":1200,"す.":-1310,"す。":-1310,"する":6521,"ず,":3426,"ず、":3426,"ずに":841,"そう":428,"た.":8875,"た。":8875,"たい":-594,"たの":812,"たり":-1183,"たる":-853,"だ.":4098,"だ。":4098,"だっ":1004,"った":-4748,"って":300,"てい":6240,"てお":855,"ても":302,"です":1437,"でに":-1482,"では":2295,"とう":-1387,"とし":2266,"との":541,"とも":-3543,"どう":4664,"ない":1796,"なく":-903,"など":2135,"に,":-1021,"に、":-1021,"にし":1771,"にな":1906,"には":2644,"の,":-724,"の、":-724,"の子":-1000,"は,":1337,"は、":1337,"べき":2181,"まし":1113,"ます":6943,"まっ":-1549,"まで":6154,"まれ":-793,"らし":1479,"られ":6820,"るる":3818,"れ,":854,"れ、":854,"れた":1850,"れて":1375,"れば":-3246,"れる":1091,"われ":-605,"んだ":606,"んで":798,"カ月":990,"会議":860,"入り":1232,"大会":2217,"始め":1681,"市":965,"新聞":-5055,"日,":974,"日、":974,"社会":2024,"ｶ月":990}; + this.TC1__ = {"AAA":1093,"HHH":1029,"HHM":580,"HII":998,"HOH":-390,"HOM":-331,"IHI":1169,"IOH":-142,"IOI":-1015,"IOM":467,"MMH":187,"OOI":-1832}; + this.TC2__ = {"HHO":2088,"HII":-1023,"HMM":-1154,"IHI":-1965,"KKH":703,"OII":-2649}; + this.TC3__ = {"AAA":-294,"HHH":346,"HHI":-341,"HII":-1088,"HIK":731,"HOH":-1486,"IHH":128,"IHI":-3041,"IHO":-1935,"IIH":-825,"IIM":-1035,"IOI":-542,"KHH":-1216,"KKA":491,"KKH":-1217,"KOK":-1009,"MHH":-2694,"MHM":-457,"MHO":123,"MMH":-471,"NNH":-1689,"NNO":662,"OHO":-3393}; + this.TC4__ = {"HHH":-203,"HHI":1344,"HHK":365,"HHM":-122,"HHN":182,"HHO":669,"HIH":804,"HII":679,"HOH":446,"IHH":695,"IHO":-2324,"IIH":321,"III":1497,"IIO":656,"IOO":54,"KAK":4845,"KKA":3386,"KKK":3065,"MHH":-405,"MHI":201,"MMH":-241,"MMM":661,"MOM":841}; + this.TQ1__ = {"BHHH":-227,"BHHI":316,"BHIH":-132,"BIHH":60,"BIII":1595,"BNHH":-744,"BOHH":225,"BOOO":-908,"OAKK":482,"OHHH":281,"OHIH":249,"OIHI":200,"OIIH":-68}; + this.TQ2__ = {"BIHH":-1401,"BIII":-1033,"BKAK":-543,"BOOO":-5591}; + this.TQ3__ = {"BHHH":478,"BHHM":-1073,"BHIH":222,"BHII":-504,"BIIH":-116,"BIII":-105,"BMHI":-863,"BMHM":-464,"BOMH":620,"OHHH":346,"OHHI":1729,"OHII":997,"OHMH":481,"OIHH":623,"OIIH":1344,"OKAK":2792,"OKHH":587,"OKKA":679,"OOHH":110,"OOII":-685}; + this.TQ4__ = {"BHHH":-721,"BHHM":-3604,"BHII":-966,"BIIH":-607,"BIII":-2181,"OAAA":-2763,"OAKK":180,"OHHH":-294,"OHHI":2446,"OHHO":480,"OHIH":-1573,"OIHH":1935,"OIHI":-493,"OIIH":626,"OIII":-4007,"OKAK":-8156}; + this.TW1__ = {"につい":-4681,"東京都":2026}; + this.TW2__ = {"ある程":-2049,"いった":-1256,"ころが":-2434,"しょう":3873,"その後":-4430,"だって":-1049,"ていた":1833,"として":-4657,"ともに":-4517,"もので":1882,"一気に":-792,"初めて":-1512,"同時に":-8097,"大きな":-1255,"対して":-2721,"社会党":-3216}; + this.TW3__ = {"いただ":-1734,"してい":1314,"として":-4314,"につい":-5483,"にとっ":-5989,"に当た":-6247,"ので,":-727,"ので、":-727,"のもの":-600,"れから":-3752,"十二月":-2287}; + this.TW4__ = {"いう.":8576,"いう。":8576,"からな":-2348,"してい":2958,"たが,":1516,"たが、":1516,"ている":1538,"という":1349,"ました":5543,"ません":1097,"ようと":-4258,"よると":5865}; + this.UC1__ = {"A":484,"K":93,"M":645,"O":-505}; + this.UC2__ = {"A":819,"H":1059,"I":409,"M":3987,"N":5775,"O":646}; + this.UC3__ = {"A":-1370,"I":2311}; + this.UC4__ = {"A":-2643,"H":1809,"I":-1032,"K":-3450,"M":3565,"N":3876,"O":6646}; + this.UC5__ = {"H":313,"I":-1238,"K":-799,"M":539,"O":-831}; + this.UC6__ = {"H":-506,"I":-253,"K":87,"M":247,"O":-387}; + this.UP1__ = {"O":-214}; + this.UP2__ = {"B":69,"O":935}; + this.UP3__ = {"B":189}; + this.UQ1__ = {"BH":21,"BI":-12,"BK":-99,"BN":142,"BO":-56,"OH":-95,"OI":477,"OK":410,"OO":-2422}; + this.UQ2__ = {"BH":216,"BI":113,"OK":1759}; + this.UQ3__ = {"BA":-479,"BH":42,"BI":1913,"BK":-7198,"BM":3160,"BN":6427,"BO":14761,"OI":-827,"ON":-3212}; + this.UW1__ = {",":156,"、":156,"「":-463,"あ":-941,"う":-127,"が":-553,"き":121,"こ":505,"で":-201,"と":-547,"ど":-123,"に":-789,"の":-185,"は":-847,"も":-466,"や":-470,"よ":182,"ら":-292,"り":208,"れ":169,"を":-446,"ん":-137,"・":-135,"主":-402,"京":-268,"区":-912,"午":871,"国":-460,"大":561,"委":729,"市":-411,"日":-141,"理":361,"生":-408,"県":-386,"都":-718,"｢":-463,"･":-135}; + this.UW2__ = {",":-829,"、":-829,"〇":892,"「":-645,"」":3145,"あ":-538,"い":505,"う":134,"お":-502,"か":1454,"が":-856,"く":-412,"こ":1141,"さ":878,"ざ":540,"し":1529,"す":-675,"せ":300,"そ":-1011,"た":188,"だ":1837,"つ":-949,"て":-291,"で":-268,"と":-981,"ど":1273,"な":1063,"に":-1764,"の":130,"は":-409,"ひ":-1273,"べ":1261,"ま":600,"も":-1263,"や":-402,"よ":1639,"り":-579,"る":-694,"れ":571,"を":-2516,"ん":2095,"ア":-587,"カ":306,"キ":568,"ッ":831,"三":-758,"不":-2150,"世":-302,"中":-968,"主":-861,"事":492,"人":-123,"会":978,"保":362,"入":548,"初":-3025,"副":-1566,"北":-3414,"区":-422,"大":-1769,"天":-865,"太":-483,"子":-1519,"学":760,"実":1023,"小":-2009,"市":-813,"年":-1060,"強":1067,"手":-1519,"揺":-1033,"政":1522,"文":-1355,"新":-1682,"日":-1815,"明":-1462,"最":-630,"朝":-1843,"本":-1650,"東":-931,"果":-665,"次":-2378,"民":-180,"気":-1740,"理":752,"発":529,"目":-1584,"相":-242,"県":-1165,"立":-763,"第":810,"米":509,"自":-1353,"行":838,"西":-744,"見":-3874,"調":1010,"議":1198,"込":3041,"開":1758,"間":-1257,"｢":-645,"｣":3145,"ｯ":831,"ｱ":-587,"ｶ":306,"ｷ":568}; + this.UW3__ = {",":4889,"1":-800,"−":-1723,"、":4889,"々":-2311,"〇":5827,"」":2670,"〓":-3573,"あ":-2696,"い":1006,"う":2342,"え":1983,"お":-4864,"か":-1163,"が":3271,"く":1004,"け":388,"げ":401,"こ":-3552,"ご":-3116,"さ":-1058,"し":-395,"す":584,"せ":3685,"そ":-5228,"た":842,"ち":-521,"っ":-1444,"つ":-1081,"て":6167,"で":2318,"と":1691,"ど":-899,"な":-2788,"に":2745,"の":4056,"は":4555,"ひ":-2171,"ふ":-1798,"へ":1199,"ほ":-5516,"ま":-4384,"み":-120,"め":1205,"も":2323,"や":-788,"よ":-202,"ら":727,"り":649,"る":5905,"れ":2773,"わ":-1207,"を":6620,"ん":-518,"ア":551,"グ":1319,"ス":874,"ッ":-1350,"ト":521,"ム":1109,"ル":1591,"ロ":2201,"ン":278,"・":-3794,"一":-1619,"下":-1759,"世":-2087,"両":3815,"中":653,"主":-758,"予":-1193,"二":974,"人":2742,"今":792,"他":1889,"以":-1368,"低":811,"何":4265,"作":-361,"保":-2439,"元":4858,"党":3593,"全":1574,"公":-3030,"六":755,"共":-1880,"円":5807,"再":3095,"分":457,"初":2475,"別":1129,"前":2286,"副":4437,"力":365,"動":-949,"務":-1872,"化":1327,"北":-1038,"区":4646,"千":-2309,"午":-783,"協":-1006,"口":483,"右":1233,"各":3588,"合":-241,"同":3906,"和":-837,"員":4513,"国":642,"型":1389,"場":1219,"外":-241,"妻":2016,"学":-1356,"安":-423,"実":-1008,"家":1078,"小":-513,"少":-3102,"州":1155,"市":3197,"平":-1804,"年":2416,"広":-1030,"府":1605,"度":1452,"建":-2352,"当":-3885,"得":1905,"思":-1291,"性":1822,"戸":-488,"指":-3973,"政":-2013,"教":-1479,"数":3222,"文":-1489,"新":1764,"日":2099,"旧":5792,"昨":-661,"時":-1248,"曜":-951,"最":-937,"月":4125,"期":360,"李":3094,"村":364,"東":-805,"核":5156,"森":2438,"業":484,"氏":2613,"民":-1694,"決":-1073,"法":1868,"海":-495,"無":979,"物":461,"特":-3850,"生":-273,"用":914,"町":1215,"的":7313,"直":-1835,"省":792,"県":6293,"知":-1528,"私":4231,"税":401,"立":-960,"第":1201,"米":7767,"系":3066,"約":3663,"級":1384,"統":-4229,"総":1163,"線":1255,"者":6457,"能":725,"自":-2869,"英":785,"見":1044,"調":-562,"財":-733,"費":1777,"車":1835,"軍":1375,"込":-1504,"通":-1136,"選":-681,"郎":1026,"郡":4404,"部":1200,"金":2163,"長":421,"開":-1432,"間":1302,"関":-1282,"雨":2009,"電":-1045,"非":2066,"駅":1620,"１":-800,"｣":2670,"･":-3794,"ｯ":-1350,"ｱ":551,"ｸﾞ":1319,"ｽ":874,"ﾄ":521,"ﾑ":1109,"ﾙ":1591,"ﾛ":2201,"ﾝ":278}; + this.UW4__ = {",":3930,".":3508,"―":-4841,"、":3930,"。":3508,"〇":4999,"「":1895,"」":3798,"〓":-5156,"あ":4752,"い":-3435,"う":-640,"え":-2514,"お":2405,"か":530,"が":6006,"き":-4482,"ぎ":-3821,"く":-3788,"け":-4376,"げ":-4734,"こ":2255,"ご":1979,"さ":2864,"し":-843,"じ":-2506,"す":-731,"ず":1251,"せ":181,"そ":4091,"た":5034,"だ":5408,"ち":-3654,"っ":-5882,"つ":-1659,"て":3994,"で":7410,"と":4547,"な":5433,"に":6499,"ぬ":1853,"ね":1413,"の":7396,"は":8578,"ば":1940,"ひ":4249,"び":-4134,"ふ":1345,"へ":6665,"べ":-744,"ほ":1464,"ま":1051,"み":-2082,"む":-882,"め":-5046,"も":4169,"ゃ":-2666,"や":2795,"ょ":-1544,"よ":3351,"ら":-2922,"り":-9726,"る":-14896,"れ":-2613,"ろ":-4570,"わ":-1783,"を":13150,"ん":-2352,"カ":2145,"コ":1789,"セ":1287,"ッ":-724,"ト":-403,"メ":-1635,"ラ":-881,"リ":-541,"ル":-856,"ン":-3637,"・":-4371,"ー":-11870,"一":-2069,"中":2210,"予":782,"事":-190,"井":-1768,"人":1036,"以":544,"会":950,"体":-1286,"作":530,"側":4292,"先":601,"党":-2006,"共":-1212,"内":584,"円":788,"初":1347,"前":1623,"副":3879,"力":-302,"動":-740,"務":-2715,"化":776,"区":4517,"協":1013,"参":1555,"合":-1834,"和":-681,"員":-910,"器":-851,"回":1500,"国":-619,"園":-1200,"地":866,"場":-1410,"塁":-2094,"士":-1413,"多":1067,"大":571,"子":-4802,"学":-1397,"定":-1057,"寺":-809,"小":1910,"屋":-1328,"山":-1500,"島":-2056,"川":-2667,"市":2771,"年":374,"庁":-4556,"後":456,"性":553,"感":916,"所":-1566,"支":856,"改":787,"政":2182,"教":704,"文":522,"方":-856,"日":1798,"時":1829,"最":845,"月":-9066,"木":-485,"来":-442,"校":-360,"業":-1043,"氏":5388,"民":-2716,"気":-910,"沢":-939,"済":-543,"物":-735,"率":672,"球":-1267,"生":-1286,"産":-1101,"田":-2900,"町":1826,"的":2586,"目":922,"省":-3485,"県":2997,"空":-867,"立":-2112,"第":788,"米":2937,"系":786,"約":2171,"経":1146,"統":-1169,"総":940,"線":-994,"署":749,"者":2145,"能":-730,"般":-852,"行":-792,"規":792,"警":-1184,"議":-244,"谷":-1000,"賞":730,"車":-1481,"軍":1158,"輪":-1433,"込":-3370,"近":929,"道":-1291,"選":2596,"郎":-4866,"都":1192,"野":-1100,"銀":-2213,"長":357,"間":-2344,"院":-2297,"際":-2604,"電":-878,"領":-1659,"題":-792,"館":-1984,"首":1749,"高":2120,"｢":1895,"｣":3798,"･":-4371,"ｯ":-724,"ｰ":-11870,"ｶ":2145,"ｺ":1789,"ｾ":1287,"ﾄ":-403,"ﾒ":-1635,"ﾗ":-881,"ﾘ":-541,"ﾙ":-856,"ﾝ":-3637}; + this.UW5__ = {",":465,".":-299,"1":-514,"E2":-32768,"]":-2762,"、":465,"。":-299,"「":363,"あ":1655,"い":331,"う":-503,"え":1199,"お":527,"か":647,"が":-421,"き":1624,"ぎ":1971,"く":312,"げ":-983,"さ":-1537,"し":-1371,"す":-852,"だ":-1186,"ち":1093,"っ":52,"つ":921,"て":-18,"で":-850,"と":-127,"ど":1682,"な":-787,"に":-1224,"の":-635,"は":-578,"べ":1001,"み":502,"め":865,"ゃ":3350,"ょ":854,"り":-208,"る":429,"れ":504,"わ":419,"を":-1264,"ん":327,"イ":241,"ル":451,"ン":-343,"中":-871,"京":722,"会":-1153,"党":-654,"務":3519,"区":-901,"告":848,"員":2104,"大":-1296,"学":-548,"定":1785,"嵐":-1304,"市":-2991,"席":921,"年":1763,"思":872,"所":-814,"挙":1618,"新":-1682,"日":218,"月":-4353,"査":932,"格":1356,"機":-1508,"氏":-1347,"田":240,"町":-3912,"的":-3149,"相":1319,"省":-1052,"県":-4003,"研":-997,"社":-278,"空":-813,"統":1955,"者":-2233,"表":663,"語":-1073,"議":1219,"選":-1018,"郎":-368,"長":786,"間":1191,"題":2368,"館":-689,"１":-514,"Ｅ２":-32768,"｢":363,"ｲ":241,"ﾙ":451,"ﾝ":-343}; + this.UW6__ = {",":227,".":808,"1":-270,"E1":306,"、":227,"。":808,"あ":-307,"う":189,"か":241,"が":-73,"く":-121,"こ":-200,"じ":1782,"す":383,"た":-428,"っ":573,"て":-1014,"で":101,"と":-105,"な":-253,"に":-149,"の":-417,"は":-236,"も":-206,"り":187,"る":-135,"を":195,"ル":-673,"ン":-496,"一":-277,"中":201,"件":-800,"会":624,"前":302,"区":1792,"員":-1212,"委":798,"学":-960,"市":887,"広":-695,"後":535,"業":-697,"相":753,"社":-507,"福":974,"空":-822,"者":1811,"連":463,"郎":1082,"１":-270,"Ｅ１":306,"ﾙ":-673,"ﾝ":-496}; + + return this; + } + TinySegmenter.prototype.ctype_ = function(str) { + for (var i in this.chartype_) { + if (str.match(this.chartype_[i][0])) { + return this.chartype_[i][1]; + } + } + return "O"; + } + + TinySegmenter.prototype.ts_ = function(v) { + if (v) { return v; } + return 0; + } + + TinySegmenter.prototype.segment = function(input) { + if (input == null || input == undefined || input == "") { + return []; + } + var result = []; + var seg = ["B3","B2","B1"]; + var ctype = ["O","O","O"]; + var o = input.split(""); + for (i = 0; i < o.length; ++i) { + seg.push(o[i]); + ctype.push(this.ctype_(o[i])) + } + seg.push("E1"); + seg.push("E2"); + seg.push("E3"); + ctype.push("O"); + ctype.push("O"); + ctype.push("O"); + var word = seg[3]; + var p1 = "U"; + var p2 = "U"; + var p3 = "U"; + for (var i = 4; i < seg.length - 3; ++i) { + var score = this.BIAS__; + var w1 = seg[i-3]; + var w2 = seg[i-2]; + var w3 = seg[i-1]; + var w4 = seg[i]; + var w5 = seg[i+1]; + var w6 = seg[i+2]; + var c1 = ctype[i-3]; + var c2 = ctype[i-2]; + var c3 = ctype[i-1]; + var c4 = ctype[i]; + var c5 = ctype[i+1]; + var c6 = ctype[i+2]; + score += this.ts_(this.UP1__[p1]); + score += this.ts_(this.UP2__[p2]); + score += this.ts_(this.UP3__[p3]); + score += this.ts_(this.BP1__[p1 + p2]); + score += this.ts_(this.BP2__[p2 + p3]); + score += this.ts_(this.UW1__[w1]); + score += this.ts_(this.UW2__[w2]); + score += this.ts_(this.UW3__[w3]); + score += this.ts_(this.UW4__[w4]); + score += this.ts_(this.UW5__[w5]); + score += this.ts_(this.UW6__[w6]); + score += this.ts_(this.BW1__[w2 + w3]); + score += this.ts_(this.BW2__[w3 + w4]); + score += this.ts_(this.BW3__[w4 + w5]); + score += this.ts_(this.TW1__[w1 + w2 + w3]); + score += this.ts_(this.TW2__[w2 + w3 + w4]); + score += this.ts_(this.TW3__[w3 + w4 + w5]); + score += this.ts_(this.TW4__[w4 + w5 + w6]); + score += this.ts_(this.UC1__[c1]); + score += this.ts_(this.UC2__[c2]); + score += this.ts_(this.UC3__[c3]); + score += this.ts_(this.UC4__[c4]); + score += this.ts_(this.UC5__[c5]); + score += this.ts_(this.UC6__[c6]); + score += this.ts_(this.BC1__[c2 + c3]); + score += this.ts_(this.BC2__[c3 + c4]); + score += this.ts_(this.BC3__[c4 + c5]); + score += this.ts_(this.TC1__[c1 + c2 + c3]); + score += this.ts_(this.TC2__[c2 + c3 + c4]); + score += this.ts_(this.TC3__[c3 + c4 + c5]); + score += this.ts_(this.TC4__[c4 + c5 + c6]); + // score += this.ts_(this.TC5__[c4 + c5 + c6]); + score += this.ts_(this.UQ1__[p1 + c1]); + score += this.ts_(this.UQ2__[p2 + c2]); + score += this.ts_(this.UQ3__[p3 + c3]); + score += this.ts_(this.BQ1__[p2 + c2 + c3]); + score += this.ts_(this.BQ2__[p2 + c3 + c4]); + score += this.ts_(this.BQ3__[p3 + c2 + c3]); + score += this.ts_(this.BQ4__[p3 + c3 + c4]); + score += this.ts_(this.TQ1__[p2 + c1 + c2 + c3]); + score += this.ts_(this.TQ2__[p2 + c2 + c3 + c4]); + score += this.ts_(this.TQ3__[p3 + c1 + c2 + c3]); + score += this.ts_(this.TQ4__[p3 + c2 + c3 + c4]); + var p = "O"; + if (score > 0) { + result.push(word); + word = ""; + p = "B"; + } + p1 = p2; + p2 = p3; + p3 = p; + word += seg[i]; + } + result.push(word); + + return result; + } + + lunr.TinySegmenter = TinySegmenter; + }; + +})); \ No newline at end of file diff --git a/assets/javascripts/lunr/wordcut.js b/assets/javascripts/lunr/wordcut.js new file mode 100644 index 00000000..146f4b44 --- /dev/null +++ b/assets/javascripts/lunr/wordcut.js @@ -0,0 +1,6708 @@ +(function(f){if(typeof exports==="object"&&typeof module!=="undefined"){module.exports=f()}else if(typeof define==="function"&&define.amd){define([],f)}else{var g;if(typeof window!=="undefined"){g=window}else if(typeof global!=="undefined"){g=global}else if(typeof self!=="undefined"){g=self}else{g=this}(g.lunr || (g.lunr = {})).wordcut = f()}})(function(){var define,module,exports;return (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o 1; + }) + this.addWords(words, false) + } + if(finalize){ + this.finalizeDict(); + } + }, + + dictSeek: function (l, r, ch, strOffset, pos) { + var ans = null; + while (l <= r) { + var m = Math.floor((l + r) / 2), + dict_item = this.dict[m], + len = dict_item.length; + if (len <= strOffset) { + l = m + 1; + } else { + var ch_ = dict_item[strOffset]; + if (ch_ < ch) { + l = m + 1; + } else if (ch_ > ch) { + r = m - 1; + } else { + ans = m; + if (pos == LEFT) { + r = m - 1; + } else { + l = m + 1; + } + } + } + } + return ans; + }, + + isFinal: function (acceptor) { + return this.dict[acceptor.l].length == acceptor.strOffset; + }, + + createAcceptor: function () { + return { + l: 0, + r: this.dict.length - 1, + strOffset: 0, + isFinal: false, + dict: this, + transit: function (ch) { + return this.dict.transit(this, ch); + }, + isError: false, + tag: "DICT", + w: 1, + type: "DICT" + }; + }, + + transit: function (acceptor, ch) { + var l = this.dictSeek(acceptor.l, + acceptor.r, + ch, + acceptor.strOffset, + LEFT); + if (l !== null) { + var r = this.dictSeek(l, + acceptor.r, + ch, + acceptor.strOffset, + RIGHT); + acceptor.l = l; + acceptor.r = r; + acceptor.strOffset++; + acceptor.isFinal = this.isFinal(acceptor); + } else { + acceptor.isError = true; + } + return acceptor; + }, + + sortuniq: function(a){ + return a.sort().filter(function(item, pos, arr){ + return !pos || item != arr[pos - 1]; + }) + }, + + flatten: function(a){ + //[[1,2],[3]] -> [1,2,3] + return [].concat.apply([], a); + } +}; +module.exports = WordcutDict; + +}).call(this,"/dist/tmp") +},{"glob":16,"path":22}],3:[function(require,module,exports){ +var WordRule = { + createAcceptor: function(tag) { + if (tag["WORD_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + var lch = ch.toLowerCase(); + if (lch >= "a" && lch <= "z") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "WORD_RULE", + type: "WORD_RULE", + w: 1}; + } +}; + +var NumberRule = { + createAcceptor: function(tag) { + if (tag["NUMBER_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch >= "0" && ch <= "9") { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "NUMBER_RULE", + type: "NUMBER_RULE", + w: 1}; + } +}; + +var SpaceRule = { + tag: "SPACE_RULE", + createAcceptor: function(tag) { + + if (tag["SPACE_RULE"]) + return null; + + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (ch == " " || ch == "\t" || ch == "\r" || ch == "\n" || + ch == "\u00A0" || ch=="\u2003"//nbsp and emsp + ) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: SpaceRule.tag, + w: 1, + type: "SPACE_RULE"}; + } +} + +var SingleSymbolRule = { + tag: "SINSYM", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (this.strOffset == 0 && ch.match(/^[\@\(\)\/\,\-\."`]$/)) { + this.isFinal = true; + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "SINSYM", + w: 1, + type: "SINSYM"}; + } +} + + +var LatinRules = [WordRule, SpaceRule, SingleSymbolRule, NumberRule]; + +module.exports = LatinRules; + +},{}],4:[function(require,module,exports){ +var _ = require("underscore") + , WordcutCore = require("./wordcut_core"); +var PathInfoBuilder = { + + /* + buildByPartAcceptors: function(path, acceptors, i) { + var + var genInfos = partAcceptors.reduce(function(genInfos, acceptor) { + + }, []); + + return genInfos; + } + */ + + buildByAcceptors: function(path, finalAcceptors, i) { + var self = this; + var infos = finalAcceptors.map(function(acceptor) { + var p = i - acceptor.strOffset + 1 + , _info = path[p]; + + var info = {p: p, + mw: _info.mw + (acceptor.mw === undefined ? 0 : acceptor.mw), + w: acceptor.w + _info.w, + unk: (acceptor.unk ? acceptor.unk : 0) + _info.unk, + type: acceptor.type}; + + if (acceptor.type == "PART") { + for(var j = p + 1; j <= i; j++) { + path[j].merge = p; + } + info.merge = p; + } + + return info; + }); + return infos.filter(function(info) { return info; }); + }, + + fallback: function(path, leftBoundary, text, i) { + var _info = path[leftBoundary]; + if (text[i].match(/[\u0E48-\u0E4E]/)) { + if (leftBoundary != 0) + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + mw: 0, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; +/* } else if(leftBoundary > 0 && path[leftBoundary].type !== "UNK") { + leftBoundary = path[leftBoundary].p; + return {p: leftBoundary, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; */ + } else { + return {p: leftBoundary, + mw: _info.mw, + w: 1 + _info.w, + unk: 1 + _info.unk, + type: "UNK"}; + } + }, + + build: function(path, finalAcceptors, i, leftBoundary, text) { + var basicPathInfos = this.buildByAcceptors(path, finalAcceptors, i); + if (basicPathInfos.length > 0) { + return basicPathInfos; + } else { + return [this.fallback(path, leftBoundary, text, i)]; + } + } +}; + +module.exports = function() { + return _.clone(PathInfoBuilder); +} + +},{"./wordcut_core":8,"underscore":25}],5:[function(require,module,exports){ +var _ = require("underscore"); + + +var PathSelector = { + selectPath: function(paths) { + var path = paths.reduce(function(selectedPath, path) { + if (selectedPath == null) { + return path; + } else { + if (path.unk < selectedPath.unk) + return path; + if (path.unk == selectedPath.unk) { + if (path.mw < selectedPath.mw) + return path + if (path.mw == selectedPath.mw) { + if (path.w < selectedPath.w) + return path; + } + } + return selectedPath; + } + }, null); + return path; + }, + + createPath: function() { + return [{p:null, w:0, unk:0, type: "INIT", mw:0}]; + } +}; + +module.exports = function() { + return _.clone(PathSelector); +}; + +},{"underscore":25}],6:[function(require,module,exports){ +function isMatch(pat, offset, ch) { + if (pat.length <= offset) + return false; + var _ch = pat[offset]; + return _ch == ch || + (_ch.match(/[กข]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/[มบ]/) && ch.match(/[ก-ฮ]/)) || + (_ch.match(/\u0E49/) && ch.match(/[\u0E48-\u0E4B]/)); +} + +var Rule0 = { + pat: "เหก็ม", + createAcceptor: function(tag) { + return {strOffset: 0, + isFinal: false, + transit: function(ch) { + if (isMatch(Rule0.pat, this.strOffset,ch)) { + this.isFinal = (this.strOffset + 1 == Rule0.pat.length); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "THAI_RULE", + type: "THAI_RULE", + w: 1}; + } +}; + +var PartRule = { + createAcceptor: function(tag) { + return {strOffset: 0, + patterns: [ + "แก", "เก", "ก้", "กก์", "กา", "กี", "กิ", "กืก" + ], + isFinal: false, + transit: function(ch) { + var offset = this.strOffset; + this.patterns = this.patterns.filter(function(pat) { + return isMatch(pat, offset, ch); + }); + + if (this.patterns.length > 0) { + var len = 1 + offset; + this.isFinal = this.patterns.some(function(pat) { + return pat.length == len; + }); + this.strOffset++; + } else { + this.isError = true; + } + return this; + }, + isError: false, + tag: "PART", + type: "PART", + unk: 1, + w: 1}; + } +}; + +var ThaiRules = [Rule0, PartRule]; + +module.exports = ThaiRules; + +},{}],7:[function(require,module,exports){ +var sys = require("sys") + , WordcutDict = require("./dict") + , WordcutCore = require("./wordcut_core") + , PathInfoBuilder = require("./path_info_builder") + , PathSelector = require("./path_selector") + , Acceptors = require("./acceptors") + , latinRules = require("./latin_rules") + , thaiRules = require("./thai_rules") + , _ = require("underscore"); + + +var Wordcut = Object.create(WordcutCore); +Wordcut.defaultPathInfoBuilder = PathInfoBuilder; +Wordcut.defaultPathSelector = PathSelector; +Wordcut.defaultAcceptors = Acceptors; +Wordcut.defaultLatinRules = latinRules; +Wordcut.defaultThaiRules = thaiRules; +Wordcut.defaultDict = WordcutDict; + + +Wordcut.initNoDict = function(dict_path) { + var self = this; + self.pathInfoBuilder = new self.defaultPathInfoBuilder; + self.pathSelector = new self.defaultPathSelector; + self.acceptors = new self.defaultAcceptors; + self.defaultLatinRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); + self.defaultThaiRules.forEach(function(rule) { + self.acceptors.creators.push(rule); + }); +}; + +Wordcut.init = function(dict_path, withDefault, additionalWords) { + withDefault = withDefault || false; + this.initNoDict(); + var dict = _.clone(this.defaultDict); + dict.init(dict_path, withDefault, additionalWords); + this.acceptors.creators.push(dict); +}; + +module.exports = Wordcut; + +},{"./acceptors":1,"./dict":2,"./latin_rules":3,"./path_info_builder":4,"./path_selector":5,"./thai_rules":6,"./wordcut_core":8,"sys":28,"underscore":25}],8:[function(require,module,exports){ +var WordcutCore = { + + buildPath: function(text) { + var self = this + , path = self.pathSelector.createPath() + , leftBoundary = 0; + self.acceptors.reset(); + for (var i = 0; i < text.length; i++) { + var ch = text[i]; + self.acceptors.transit(ch); + + var possiblePathInfos = self + .pathInfoBuilder + .build(path, + self.acceptors.getFinalAcceptors(), + i, + leftBoundary, + text); + var selectedPath = self.pathSelector.selectPath(possiblePathInfos) + + path.push(selectedPath); + if (selectedPath.type !== "UNK") { + leftBoundary = i; + } + } + return path; + }, + + pathToRanges: function(path) { + var e = path.length - 1 + , ranges = []; + + while (e > 0) { + var info = path[e] + , s = info.p; + + if (info.merge !== undefined && ranges.length > 0) { + var r = ranges[ranges.length - 1]; + r.s = info.merge; + s = r.s; + } else { + ranges.push({s:s, e:e}); + } + e = s; + } + return ranges.reverse(); + }, + + rangesToText: function(text, ranges, delimiter) { + return ranges.map(function(r) { + return text.substring(r.s, r.e); + }).join(delimiter); + }, + + cut: function(text, delimiter) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + return this + .rangesToText(text, ranges, + (delimiter === undefined ? "|" : delimiter)); + }, + + cutIntoRanges: function(text, noText) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + if (!noText) { + ranges.forEach(function(r) { + r.text = text.substring(r.s, r.e); + }); + } + return ranges; + }, + + cutIntoArray: function(text) { + var path = this.buildPath(text) + , ranges = this.pathToRanges(path); + + return ranges.map(function(r) { + return text.substring(r.s, r.e) + }); + } +}; + +module.exports = WordcutCore; + +},{}],9:[function(require,module,exports){ +// http://wiki.commonjs.org/wiki/Unit_Testing/1.0 +// +// THIS IS NOT TESTED NOR LIKELY TO WORK OUTSIDE V8! +// +// Originally from narwhal.js (http://narwhaljs.org) +// Copyright (c) 2009 Thomas Robinson <280north.com> +// +// Permission is hereby granted, free of charge, to any person obtaining a copy +// of this software and associated documentation files (the 'Software'), to +// deal in the Software without restriction, including without limitation the +// rights to use, copy, modify, merge, publish, distribute, sublicense, and/or +// sell copies of the Software, and to permit persons to whom the Software is +// furnished to do so, subject to the following conditions: +// +// The above copyright notice and this permission notice shall be included in +// all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +// AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN +// ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION +// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +// when used in node, this will actually load the util module we depend on +// versus loading the builtin util module as happens otherwise +// this is a bug in node module loading as far as I am concerned +var util = require('util/'); + +var pSlice = Array.prototype.slice; +var hasOwn = Object.prototype.hasOwnProperty; + +// 1. The assert module provides functions that throw +// AssertionError's when particular conditions are not met. The +// assert module must conform to the following interface. + +var assert = module.exports = ok; + +// 2. The AssertionError is defined in assert. +// new assert.AssertionError({ message: message, +// actual: actual, +// expected: expected }) + +assert.AssertionError = function AssertionError(options) { + this.name = 'AssertionError'; + this.actual = options.actual; + this.expected = options.expected; + this.operator = options.operator; + if (options.message) { + this.message = options.message; + this.generatedMessage = false; + } else { + this.message = getMessage(this); + this.generatedMessage = true; + } + var stackStartFunction = options.stackStartFunction || fail; + + if (Error.captureStackTrace) { + Error.captureStackTrace(this, stackStartFunction); + } + else { + // non v8 browsers so we can have a stacktrace + var err = new Error(); + if (err.stack) { + var out = err.stack; + + // try to strip useless frames + var fn_name = stackStartFunction.name; + var idx = out.indexOf('\n' + fn_name); + if (idx >= 0) { + // once we have located the function frame + // we need to strip out everything before it (and its line) + var next_line = out.indexOf('\n', idx + 1); + out = out.substring(next_line + 1); + } + + this.stack = out; + } + } +}; + +// assert.AssertionError instanceof Error +util.inherits(assert.AssertionError, Error); + +function replacer(key, value) { + if (util.isUndefined(value)) { + return '' + value; + } + if (util.isNumber(value) && !isFinite(value)) { + return value.toString(); + } + if (util.isFunction(value) || util.isRegExp(value)) { + return value.toString(); + } + return value; +} + +function truncate(s, n) { + if (util.isString(s)) { + return s.length < n ? s : s.slice(0, n); + } else { + return s; + } +} + +function getMessage(self) { + return truncate(JSON.stringify(self.actual, replacer), 128) + ' ' + + self.operator + ' ' + + truncate(JSON.stringify(self.expected, replacer), 128); +} + +// At present only the three keys mentioned above are used and +// understood by the spec. Implementations or sub modules can pass +// other keys to the AssertionError's constructor - they will be +// ignored. + +// 3. All of the following functions must throw an AssertionError +// when a corresponding condition is not met, with a message that +// may be undefined if not provided. All assertion methods provide +// both the actual and expected values to the assertion error for +// display purposes. + +function fail(actual, expected, message, operator, stackStartFunction) { + throw new assert.AssertionError({ + message: message, + actual: actual, + expected: expected, + operator: operator, + stackStartFunction: stackStartFunction + }); +} + +// EXTENSION! allows for well behaved errors defined elsewhere. +assert.fail = fail; + +// 4. Pure assertion tests whether a value is truthy, as determined +// by !!guard. +// assert.ok(guard, message_opt); +// This statement is equivalent to assert.equal(true, !!guard, +// message_opt);. To test strictly for the value true, use +// assert.strictEqual(true, guard, message_opt);. + +function ok(value, message) { + if (!value) fail(value, true, message, '==', assert.ok); +} +assert.ok = ok; + +// 5. The equality assertion tests shallow, coercive equality with +// ==. +// assert.equal(actual, expected, message_opt); + +assert.equal = function equal(actual, expected, message) { + if (actual != expected) fail(actual, expected, message, '==', assert.equal); +}; + +// 6. The non-equality assertion tests for whether two objects are not equal +// with != assert.notEqual(actual, expected, message_opt); + +assert.notEqual = function notEqual(actual, expected, message) { + if (actual == expected) { + fail(actual, expected, message, '!=', assert.notEqual); + } +}; + +// 7. The equivalence assertion tests a deep equality relation. +// assert.deepEqual(actual, expected, message_opt); + +assert.deepEqual = function deepEqual(actual, expected, message) { + if (!_deepEqual(actual, expected)) { + fail(actual, expected, message, 'deepEqual', assert.deepEqual); + } +}; + +function _deepEqual(actual, expected) { + // 7.1. All identical values are equivalent, as determined by ===. + if (actual === expected) { + return true; + + } else if (util.isBuffer(actual) && util.isBuffer(expected)) { + if (actual.length != expected.length) return false; + + for (var i = 0; i < actual.length; i++) { + if (actual[i] !== expected[i]) return false; + } + + return true; + + // 7.2. If the expected value is a Date object, the actual value is + // equivalent if it is also a Date object that refers to the same time. + } else if (util.isDate(actual) && util.isDate(expected)) { + return actual.getTime() === expected.getTime(); + + // 7.3 If the expected value is a RegExp object, the actual value is + // equivalent if it is also a RegExp object with the same source and + // properties (`global`, `multiline`, `lastIndex`, `ignoreCase`). + } else if (util.isRegExp(actual) && util.isRegExp(expected)) { + return actual.source === expected.source && + actual.global === expected.global && + actual.multiline === expected.multiline && + actual.lastIndex === expected.lastIndex && + actual.ignoreCase === expected.ignoreCase; + + // 7.4. Other pairs that do not both pass typeof value == 'object', + // equivalence is determined by ==. + } else if (!util.isObject(actual) && !util.isObject(expected)) { + return actual == expected; + + // 7.5 For all other Object pairs, including Array objects, equivalence is + // determined by having the same number of owned properties (as verified + // with Object.prototype.hasOwnProperty.call), the same set of keys + // (although not necessarily the same order), equivalent values for every + // corresponding key, and an identical 'prototype' property. Note: this + // accounts for both named and indexed properties on Arrays. + } else { + return objEquiv(actual, expected); + } +} + +function isArguments(object) { + return Object.prototype.toString.call(object) == '[object Arguments]'; +} + +function objEquiv(a, b) { + if (util.isNullOrUndefined(a) || util.isNullOrUndefined(b)) + return false; + // an identical 'prototype' property. + if (a.prototype !== b.prototype) return false; + // if one is a primitive, the other must be same + if (util.isPrimitive(a) || util.isPrimitive(b)) { + return a === b; + } + var aIsArgs = isArguments(a), + bIsArgs = isArguments(b); + if ((aIsArgs && !bIsArgs) || (!aIsArgs && bIsArgs)) + return false; + if (aIsArgs) { + a = pSlice.call(a); + b = pSlice.call(b); + return _deepEqual(a, b); + } + var ka = objectKeys(a), + kb = objectKeys(b), + key, i; + // having the same number of owned properties (keys incorporates + // hasOwnProperty) + if (ka.length != kb.length) + return false; + //the same set of keys (although not necessarily the same order), + ka.sort(); + kb.sort(); + //~~~cheap key test + for (i = ka.length - 1; i >= 0; i--) { + if (ka[i] != kb[i]) + return false; + } + //equivalent values for every corresponding key, and + //~~~possibly expensive deep test + for (i = ka.length - 1; i >= 0; i--) { + key = ka[i]; + if (!_deepEqual(a[key], b[key])) return false; + } + return true; +} + +// 8. The non-equivalence assertion tests for any deep inequality. +// assert.notDeepEqual(actual, expected, message_opt); + +assert.notDeepEqual = function notDeepEqual(actual, expected, message) { + if (_deepEqual(actual, expected)) { + fail(actual, expected, message, 'notDeepEqual', assert.notDeepEqual); + } +}; + +// 9. The strict equality assertion tests strict equality, as determined by ===. +// assert.strictEqual(actual, expected, message_opt); + +assert.strictEqual = function strictEqual(actual, expected, message) { + if (actual !== expected) { + fail(actual, expected, message, '===', assert.strictEqual); + } +}; + +// 10. The strict non-equality assertion tests for strict inequality, as +// determined by !==. assert.notStrictEqual(actual, expected, message_opt); + +assert.notStrictEqual = function notStrictEqual(actual, expected, message) { + if (actual === expected) { + fail(actual, expected, message, '!==', assert.notStrictEqual); + } +}; + +function expectedException(actual, expected) { + if (!actual || !expected) { + return false; + } + + if (Object.prototype.toString.call(expected) == '[object RegExp]') { + return expected.test(actual); + } else if (actual instanceof expected) { + return true; + } else if (expected.call({}, actual) === true) { + return true; + } + + return false; +} + +function _throws(shouldThrow, block, expected, message) { + var actual; + + if (util.isString(expected)) { + message = expected; + expected = null; + } + + try { + block(); + } catch (e) { + actual = e; + } + + message = (expected && expected.name ? ' (' + expected.name + ').' : '.') + + (message ? ' ' + message : '.'); + + if (shouldThrow && !actual) { + fail(actual, expected, 'Missing expected exception' + message); + } + + if (!shouldThrow && expectedException(actual, expected)) { + fail(actual, expected, 'Got unwanted exception' + message); + } + + if ((shouldThrow && actual && expected && + !expectedException(actual, expected)) || (!shouldThrow && actual)) { + throw actual; + } +} + +// 11. Expected to throw an error: +// assert.throws(block, Error_opt, message_opt); + +assert.throws = function(block, /*optional*/error, /*optional*/message) { + _throws.apply(this, [true].concat(pSlice.call(arguments))); +}; + +// EXTENSION! This is annoying to write outside this module. +assert.doesNotThrow = function(block, /*optional*/message) { + _throws.apply(this, [false].concat(pSlice.call(arguments))); +}; + +assert.ifError = function(err) { if (err) {throw err;}}; + +var objectKeys = Object.keys || function (obj) { + var keys = []; + for (var key in obj) { + if (hasOwn.call(obj, key)) keys.push(key); + } + return keys; +}; + +},{"util/":28}],10:[function(require,module,exports){ +'use strict'; +module.exports = balanced; +function balanced(a, b, str) { + if (a instanceof RegExp) a = maybeMatch(a, str); + if (b instanceof RegExp) b = maybeMatch(b, str); + + var r = range(a, b, str); + + return r && { + start: r[0], + end: r[1], + pre: str.slice(0, r[0]), + body: str.slice(r[0] + a.length, r[1]), + post: str.slice(r[1] + b.length) + }; +} + +function maybeMatch(reg, str) { + var m = str.match(reg); + return m ? m[0] : null; +} + +balanced.range = range; +function range(a, b, str) { + var begs, beg, left, right, result; + var ai = str.indexOf(a); + var bi = str.indexOf(b, ai + 1); + var i = ai; + + if (ai >= 0 && bi > 0) { + begs = []; + left = str.length; + + while (i >= 0 && !result) { + if (i == ai) { + begs.push(i); + ai = str.indexOf(a, i + 1); + } else if (begs.length == 1) { + result = [ begs.pop(), bi ]; + } else { + beg = begs.pop(); + if (beg < left) { + left = beg; + right = bi; + } + + bi = str.indexOf(b, i + 1); + } + + i = ai < bi && ai >= 0 ? ai : bi; + } + + if (begs.length) { + result = [ left, right ]; + } + } + + return result; +} + +},{}],11:[function(require,module,exports){ +var concatMap = require('concat-map'); +var balanced = require('balanced-match'); + +module.exports = expandTop; + +var escSlash = '\0SLASH'+Math.random()+'\0'; +var escOpen = '\0OPEN'+Math.random()+'\0'; +var escClose = '\0CLOSE'+Math.random()+'\0'; +var escComma = '\0COMMA'+Math.random()+'\0'; +var escPeriod = '\0PERIOD'+Math.random()+'\0'; + +function numeric(str) { + return parseInt(str, 10) == str + ? parseInt(str, 10) + : str.charCodeAt(0); +} + +function escapeBraces(str) { + return str.split('\\\\').join(escSlash) + .split('\\{').join(escOpen) + .split('\\}').join(escClose) + .split('\\,').join(escComma) + .split('\\.').join(escPeriod); +} + +function unescapeBraces(str) { + return str.split(escSlash).join('\\') + .split(escOpen).join('{') + .split(escClose).join('}') + .split(escComma).join(',') + .split(escPeriod).join('.'); +} + + +// Basically just str.split(","), but handling cases +// where we have nested braced sections, which should be +// treated as individual members, like {a,{b,c},d} +function parseCommaParts(str) { + if (!str) + return ['']; + + var parts = []; + var m = balanced('{', '}', str); + + if (!m) + return str.split(','); + + var pre = m.pre; + var body = m.body; + var post = m.post; + var p = pre.split(','); + + p[p.length-1] += '{' + body + '}'; + var postParts = parseCommaParts(post); + if (post.length) { + p[p.length-1] += postParts.shift(); + p.push.apply(p, postParts); + } + + parts.push.apply(parts, p); + + return parts; +} + +function expandTop(str) { + if (!str) + return []; + + // I don't know why Bash 4.3 does this, but it does. + // Anything starting with {} will have the first two bytes preserved + // but *only* at the top level, so {},a}b will not expand to anything, + // but a{},b}c will be expanded to [a}c,abc]. + // One could argue that this is a bug in Bash, but since the goal of + // this module is to match Bash's rules, we escape a leading {} + if (str.substr(0, 2) === '{}') { + str = '\\{\\}' + str.substr(2); + } + + return expand(escapeBraces(str), true).map(unescapeBraces); +} + +function identity(e) { + return e; +} + +function embrace(str) { + return '{' + str + '}'; +} +function isPadded(el) { + return /^-?0\d/.test(el); +} + +function lte(i, y) { + return i <= y; +} +function gte(i, y) { + return i >= y; +} + +function expand(str, isTop) { + var expansions = []; + + var m = balanced('{', '}', str); + if (!m || /\$$/.test(m.pre)) return [str]; + + var isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body); + var isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body); + var isSequence = isNumericSequence || isAlphaSequence; + var isOptions = m.body.indexOf(',') >= 0; + if (!isSequence && !isOptions) { + // {a},b} + if (m.post.match(/,.*\}/)) { + str = m.pre + '{' + m.body + escClose + m.post; + return expand(str); + } + return [str]; + } + + var n; + if (isSequence) { + n = m.body.split(/\.\./); + } else { + n = parseCommaParts(m.body); + if (n.length === 1) { + // x{{a,b}}y ==> x{a}y x{b}y + n = expand(n[0], false).map(embrace); + if (n.length === 1) { + var post = m.post.length + ? expand(m.post, false) + : ['']; + return post.map(function(p) { + return m.pre + n[0] + p; + }); + } + } + } + + // at this point, n is the parts, and we know it's not a comma set + // with a single entry. + + // no need to expand pre, since it is guaranteed to be free of brace-sets + var pre = m.pre; + var post = m.post.length + ? expand(m.post, false) + : ['']; + + var N; + + if (isSequence) { + var x = numeric(n[0]); + var y = numeric(n[1]); + var width = Math.max(n[0].length, n[1].length) + var incr = n.length == 3 + ? Math.abs(numeric(n[2])) + : 1; + var test = lte; + var reverse = y < x; + if (reverse) { + incr *= -1; + test = gte; + } + var pad = n.some(isPadded); + + N = []; + + for (var i = x; test(i, y); i += incr) { + var c; + if (isAlphaSequence) { + c = String.fromCharCode(i); + if (c === '\\') + c = ''; + } else { + c = String(i); + if (pad) { + var need = width - c.length; + if (need > 0) { + var z = new Array(need + 1).join('0'); + if (i < 0) + c = '-' + z + c.slice(1); + else + c = z + c; + } + } + } + N.push(c); + } + } else { + N = concatMap(n, function(el) { return expand(el, false) }); + } + + for (var j = 0; j < N.length; j++) { + for (var k = 0; k < post.length; k++) { + var expansion = pre + N[j] + post[k]; + if (!isTop || isSequence || expansion) + expansions.push(expansion); + } + } + + return expansions; +} + + +},{"balanced-match":10,"concat-map":13}],12:[function(require,module,exports){ + +},{}],13:[function(require,module,exports){ +module.exports = function (xs, fn) { + var res = []; + for (var i = 0; i < xs.length; i++) { + var x = fn(xs[i], i); + if (isArray(x)) res.push.apply(res, x); + else res.push(x); + } + return res; +}; + +var isArray = Array.isArray || function (xs) { + return Object.prototype.toString.call(xs) === '[object Array]'; +}; + +},{}],14:[function(require,module,exports){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +function EventEmitter() { + this._events = this._events || {}; + this._maxListeners = this._maxListeners || undefined; +} +module.exports = EventEmitter; + +// Backwards-compat with node 0.10.x +EventEmitter.EventEmitter = EventEmitter; + +EventEmitter.prototype._events = undefined; +EventEmitter.prototype._maxListeners = undefined; + +// By default EventEmitters will print a warning if more than 10 listeners are +// added to it. This is a useful default which helps finding memory leaks. +EventEmitter.defaultMaxListeners = 10; + +// Obviously not all Emitters should be limited to 10. This function allows +// that to be increased. Set to zero for unlimited. +EventEmitter.prototype.setMaxListeners = function(n) { + if (!isNumber(n) || n < 0 || isNaN(n)) + throw TypeError('n must be a positive number'); + this._maxListeners = n; + return this; +}; + +EventEmitter.prototype.emit = function(type) { + var er, handler, len, args, i, listeners; + + if (!this._events) + this._events = {}; + + // If there is no 'error' event listener then throw. + if (type === 'error') { + if (!this._events.error || + (isObject(this._events.error) && !this._events.error.length)) { + er = arguments[1]; + if (er instanceof Error) { + throw er; // Unhandled 'error' event + } + throw TypeError('Uncaught, unspecified "error" event.'); + } + } + + handler = this._events[type]; + + if (isUndefined(handler)) + return false; + + if (isFunction(handler)) { + switch (arguments.length) { + // fast cases + case 1: + handler.call(this); + break; + case 2: + handler.call(this, arguments[1]); + break; + case 3: + handler.call(this, arguments[1], arguments[2]); + break; + // slower + default: + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + handler.apply(this, args); + } + } else if (isObject(handler)) { + len = arguments.length; + args = new Array(len - 1); + for (i = 1; i < len; i++) + args[i - 1] = arguments[i]; + + listeners = handler.slice(); + len = listeners.length; + for (i = 0; i < len; i++) + listeners[i].apply(this, args); + } + + return true; +}; + +EventEmitter.prototype.addListener = function(type, listener) { + var m; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events) + this._events = {}; + + // To avoid recursion in the case that type === "newListener"! Before + // adding it to the listeners, first emit "newListener". + if (this._events.newListener) + this.emit('newListener', type, + isFunction(listener.listener) ? + listener.listener : listener); + + if (!this._events[type]) + // Optimize the case of one listener. Don't need the extra array object. + this._events[type] = listener; + else if (isObject(this._events[type])) + // If we've already got an array, just append. + this._events[type].push(listener); + else + // Adding the second element, need to change to array. + this._events[type] = [this._events[type], listener]; + + // Check for listener leak + if (isObject(this._events[type]) && !this._events[type].warned) { + var m; + if (!isUndefined(this._maxListeners)) { + m = this._maxListeners; + } else { + m = EventEmitter.defaultMaxListeners; + } + + if (m && m > 0 && this._events[type].length > m) { + this._events[type].warned = true; + console.error('(node) warning: possible EventEmitter memory ' + + 'leak detected. %d listeners added. ' + + 'Use emitter.setMaxListeners() to increase limit.', + this._events[type].length); + if (typeof console.trace === 'function') { + // not supported in IE 10 + console.trace(); + } + } + } + + return this; +}; + +EventEmitter.prototype.on = EventEmitter.prototype.addListener; + +EventEmitter.prototype.once = function(type, listener) { + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + var fired = false; + + function g() { + this.removeListener(type, g); + + if (!fired) { + fired = true; + listener.apply(this, arguments); + } + } + + g.listener = listener; + this.on(type, g); + + return this; +}; + +// emits a 'removeListener' event iff the listener was removed +EventEmitter.prototype.removeListener = function(type, listener) { + var list, position, length, i; + + if (!isFunction(listener)) + throw TypeError('listener must be a function'); + + if (!this._events || !this._events[type]) + return this; + + list = this._events[type]; + length = list.length; + position = -1; + + if (list === listener || + (isFunction(list.listener) && list.listener === listener)) { + delete this._events[type]; + if (this._events.removeListener) + this.emit('removeListener', type, listener); + + } else if (isObject(list)) { + for (i = length; i-- > 0;) { + if (list[i] === listener || + (list[i].listener && list[i].listener === listener)) { + position = i; + break; + } + } + + if (position < 0) + return this; + + if (list.length === 1) { + list.length = 0; + delete this._events[type]; + } else { + list.splice(position, 1); + } + + if (this._events.removeListener) + this.emit('removeListener', type, listener); + } + + return this; +}; + +EventEmitter.prototype.removeAllListeners = function(type) { + var key, listeners; + + if (!this._events) + return this; + + // not listening for removeListener, no need to emit + if (!this._events.removeListener) { + if (arguments.length === 0) + this._events = {}; + else if (this._events[type]) + delete this._events[type]; + return this; + } + + // emit removeListener for all listeners on all events + if (arguments.length === 0) { + for (key in this._events) { + if (key === 'removeListener') continue; + this.removeAllListeners(key); + } + this.removeAllListeners('removeListener'); + this._events = {}; + return this; + } + + listeners = this._events[type]; + + if (isFunction(listeners)) { + this.removeListener(type, listeners); + } else { + // LIFO order + while (listeners.length) + this.removeListener(type, listeners[listeners.length - 1]); + } + delete this._events[type]; + + return this; +}; + +EventEmitter.prototype.listeners = function(type) { + var ret; + if (!this._events || !this._events[type]) + ret = []; + else if (isFunction(this._events[type])) + ret = [this._events[type]]; + else + ret = this._events[type].slice(); + return ret; +}; + +EventEmitter.listenerCount = function(emitter, type) { + var ret; + if (!emitter._events || !emitter._events[type]) + ret = 0; + else if (isFunction(emitter._events[type])) + ret = 1; + else + ret = emitter._events[type].length; + return ret; +}; + +function isFunction(arg) { + return typeof arg === 'function'; +} + +function isNumber(arg) { + return typeof arg === 'number'; +} + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} + +function isUndefined(arg) { + return arg === void 0; +} + +},{}],15:[function(require,module,exports){ +(function (process){ +exports.alphasort = alphasort +exports.alphasorti = alphasorti +exports.setopts = setopts +exports.ownProp = ownProp +exports.makeAbs = makeAbs +exports.finish = finish +exports.mark = mark +exports.isIgnored = isIgnored +exports.childrenIgnored = childrenIgnored + +function ownProp (obj, field) { + return Object.prototype.hasOwnProperty.call(obj, field) +} + +var path = require("path") +var minimatch = require("minimatch") +var isAbsolute = require("path-is-absolute") +var Minimatch = minimatch.Minimatch + +function alphasorti (a, b) { + return a.toLowerCase().localeCompare(b.toLowerCase()) +} + +function alphasort (a, b) { + return a.localeCompare(b) +} + +function setupIgnores (self, options) { + self.ignore = options.ignore || [] + + if (!Array.isArray(self.ignore)) + self.ignore = [self.ignore] + + if (self.ignore.length) { + self.ignore = self.ignore.map(ignoreMap) + } +} + +function ignoreMap (pattern) { + var gmatcher = null + if (pattern.slice(-3) === '/**') { + var gpattern = pattern.replace(/(\/\*\*)+$/, '') + gmatcher = new Minimatch(gpattern) + } + + return { + matcher: new Minimatch(pattern), + gmatcher: gmatcher + } +} + +function setopts (self, pattern, options) { + if (!options) + options = {} + + // base-matching: just use globstar for that. + if (options.matchBase && -1 === pattern.indexOf("/")) { + if (options.noglobstar) { + throw new Error("base matching requires globstar") + } + pattern = "**/" + pattern + } + + self.silent = !!options.silent + self.pattern = pattern + self.strict = options.strict !== false + self.realpath = !!options.realpath + self.realpathCache = options.realpathCache || Object.create(null) + self.follow = !!options.follow + self.dot = !!options.dot + self.mark = !!options.mark + self.nodir = !!options.nodir + if (self.nodir) + self.mark = true + self.sync = !!options.sync + self.nounique = !!options.nounique + self.nonull = !!options.nonull + self.nosort = !!options.nosort + self.nocase = !!options.nocase + self.stat = !!options.stat + self.noprocess = !!options.noprocess + + self.maxLength = options.maxLength || Infinity + self.cache = options.cache || Object.create(null) + self.statCache = options.statCache || Object.create(null) + self.symlinks = options.symlinks || Object.create(null) + + setupIgnores(self, options) + + self.changedCwd = false + var cwd = process.cwd() + if (!ownProp(options, "cwd")) + self.cwd = cwd + else { + self.cwd = options.cwd + self.changedCwd = path.resolve(options.cwd) !== cwd + } + + self.root = options.root || path.resolve(self.cwd, "/") + self.root = path.resolve(self.root) + if (process.platform === "win32") + self.root = self.root.replace(/\\/g, "/") + + self.nomount = !!options.nomount + + // disable comments and negation unless the user explicitly + // passes in false as the option. + options.nonegate = options.nonegate === false ? false : true + options.nocomment = options.nocomment === false ? false : true + deprecationWarning(options) + + self.minimatch = new Minimatch(pattern, options) + self.options = self.minimatch.options +} + +// TODO(isaacs): remove entirely in v6 +// exported to reset in tests +exports.deprecationWarned +function deprecationWarning(options) { + if (!options.nonegate || !options.nocomment) { + if (process.noDeprecation !== true && !exports.deprecationWarned) { + var msg = 'glob WARNING: comments and negation will be disabled in v6' + if (process.throwDeprecation) + throw new Error(msg) + else if (process.traceDeprecation) + console.trace(msg) + else + console.error(msg) + + exports.deprecationWarned = true + } + } +} + +function finish (self) { + var nou = self.nounique + var all = nou ? [] : Object.create(null) + + for (var i = 0, l = self.matches.length; i < l; i ++) { + var matches = self.matches[i] + if (!matches || Object.keys(matches).length === 0) { + if (self.nonull) { + // do like the shell, and spit out the literal glob + var literal = self.minimatch.globSet[i] + if (nou) + all.push(literal) + else + all[literal] = true + } + } else { + // had matches + var m = Object.keys(matches) + if (nou) + all.push.apply(all, m) + else + m.forEach(function (m) { + all[m] = true + }) + } + } + + if (!nou) + all = Object.keys(all) + + if (!self.nosort) + all = all.sort(self.nocase ? alphasorti : alphasort) + + // at *some* point we statted all of these + if (self.mark) { + for (var i = 0; i < all.length; i++) { + all[i] = self._mark(all[i]) + } + if (self.nodir) { + all = all.filter(function (e) { + return !(/\/$/.test(e)) + }) + } + } + + if (self.ignore.length) + all = all.filter(function(m) { + return !isIgnored(self, m) + }) + + self.found = all +} + +function mark (self, p) { + var abs = makeAbs(self, p) + var c = self.cache[abs] + var m = p + if (c) { + var isDir = c === 'DIR' || Array.isArray(c) + var slash = p.slice(-1) === '/' + + if (isDir && !slash) + m += '/' + else if (!isDir && slash) + m = m.slice(0, -1) + + if (m !== p) { + var mabs = makeAbs(self, m) + self.statCache[mabs] = self.statCache[abs] + self.cache[mabs] = self.cache[abs] + } + } + + return m +} + +// lotta situps... +function makeAbs (self, f) { + var abs = f + if (f.charAt(0) === '/') { + abs = path.join(self.root, f) + } else if (isAbsolute(f) || f === '') { + abs = f + } else if (self.changedCwd) { + abs = path.resolve(self.cwd, f) + } else { + abs = path.resolve(f) + } + return abs +} + + +// Return true, if pattern ends with globstar '**', for the accompanying parent directory. +// Ex:- If node_modules/** is the pattern, add 'node_modules' to ignore list along with it's contents +function isIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return item.matcher.match(path) || !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +function childrenIgnored (self, path) { + if (!self.ignore.length) + return false + + return self.ignore.some(function(item) { + return !!(item.gmatcher && item.gmatcher.match(path)) + }) +} + +}).call(this,require('_process')) +},{"_process":24,"minimatch":20,"path":22,"path-is-absolute":23}],16:[function(require,module,exports){ +(function (process){ +// Approach: +// +// 1. Get the minimatch set +// 2. For each pattern in the set, PROCESS(pattern, false) +// 3. Store matches per-set, then uniq them +// +// PROCESS(pattern, inGlobStar) +// Get the first [n] items from pattern that are all strings +// Join these together. This is PREFIX. +// If there is no more remaining, then stat(PREFIX) and +// add to matches if it succeeds. END. +// +// If inGlobStar and PREFIX is symlink and points to dir +// set ENTRIES = [] +// else readdir(PREFIX) as ENTRIES +// If fail, END +// +// with ENTRIES +// If pattern[n] is GLOBSTAR +// // handle the case where the globstar match is empty +// // by pruning it out, and testing the resulting pattern +// PROCESS(pattern[0..n] + pattern[n+1 .. $], false) +// // handle other cases. +// for ENTRY in ENTRIES (not dotfiles) +// // attach globstar + tail onto the entry +// // Mark that this entry is a globstar match +// PROCESS(pattern[0..n] + ENTRY + pattern[n .. $], true) +// +// else // not globstar +// for ENTRY in ENTRIES (not dotfiles, unless pattern[n] is dot) +// Test ENTRY against pattern[n] +// If fails, continue +// If passes, PROCESS(pattern[0..n] + item + pattern[n+1 .. $]) +// +// Caveat: +// Cache all stats and readdirs results to minimize syscall. Since all +// we ever care about is existence and directory-ness, we can just keep +// `true` for files, and [children,...] for directories, or `false` for +// things that don't exist. + +module.exports = glob + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var inherits = require('inherits') +var EE = require('events').EventEmitter +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var globSync = require('./sync.js') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var inflight = require('inflight') +var util = require('util') +var childrenIgnored = common.childrenIgnored +var isIgnored = common.isIgnored + +var once = require('once') + +function glob (pattern, options, cb) { + if (typeof options === 'function') cb = options, options = {} + if (!options) options = {} + + if (options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return globSync(pattern, options) + } + + return new Glob(pattern, options, cb) +} + +glob.sync = globSync +var GlobSync = glob.GlobSync = globSync.GlobSync + +// old api surface +glob.glob = glob + +glob.hasMagic = function (pattern, options_) { + var options = util._extend({}, options_) + options.noprocess = true + + var g = new Glob(pattern, options) + var set = g.minimatch.set + if (set.length > 1) + return true + + for (var j = 0; j < set[0].length; j++) { + if (typeof set[0][j] !== 'string') + return true + } + + return false +} + +glob.Glob = Glob +inherits(Glob, EE) +function Glob (pattern, options, cb) { + if (typeof options === 'function') { + cb = options + options = null + } + + if (options && options.sync) { + if (cb) + throw new TypeError('callback provided to sync glob') + return new GlobSync(pattern, options) + } + + if (!(this instanceof Glob)) + return new Glob(pattern, options, cb) + + setopts(this, pattern, options) + this._didRealPath = false + + // process each pattern in the minimatch set + var n = this.minimatch.set.length + + // The matches are stored as {: true,...} so that + // duplicates are automagically pruned. + // Later, we do an Object.keys() on these. + // Keep them as a list so we can fill in when nonull is set. + this.matches = new Array(n) + + if (typeof cb === 'function') { + cb = once(cb) + this.on('error', cb) + this.on('end', function (matches) { + cb(null, matches) + }) + } + + var self = this + var n = this.minimatch.set.length + this._processing = 0 + this.matches = new Array(n) + + this._emitQueue = [] + this._processQueue = [] + this.paused = false + + if (this.noprocess) + return this + + if (n === 0) + return done() + + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false, done) + } + + function done () { + --self._processing + if (self._processing <= 0) + self._finish() + } +} + +Glob.prototype._finish = function () { + assert(this instanceof Glob) + if (this.aborted) + return + + if (this.realpath && !this._didRealpath) + return this._realpath() + + common.finish(this) + this.emit('end', this.found) +} + +Glob.prototype._realpath = function () { + if (this._didRealpath) + return + + this._didRealpath = true + + var n = this.matches.length + if (n === 0) + return this._finish() + + var self = this + for (var i = 0; i < this.matches.length; i++) + this._realpathSet(i, next) + + function next () { + if (--n === 0) + self._finish() + } +} + +Glob.prototype._realpathSet = function (index, cb) { + var matchset = this.matches[index] + if (!matchset) + return cb() + + var found = Object.keys(matchset) + var self = this + var n = found.length + + if (n === 0) + return cb() + + var set = this.matches[index] = Object.create(null) + found.forEach(function (p, i) { + // If there's a problem with the stat, then it means that + // one or more of the links in the realpath couldn't be + // resolved. just return the abs value in that case. + p = self._makeAbs(p) + fs.realpath(p, self.realpathCache, function (er, real) { + if (!er) + set[real] = true + else if (er.syscall === 'stat') + set[p] = true + else + self.emit('error', er) // srsly wtf right here + + if (--n === 0) { + self.matches[index] = set + cb() + } + }) + }) +} + +Glob.prototype._mark = function (p) { + return common.mark(this, p) +} + +Glob.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +Glob.prototype.abort = function () { + this.aborted = true + this.emit('abort') +} + +Glob.prototype.pause = function () { + if (!this.paused) { + this.paused = true + this.emit('pause') + } +} + +Glob.prototype.resume = function () { + if (this.paused) { + this.emit('resume') + this.paused = false + if (this._emitQueue.length) { + var eq = this._emitQueue.slice(0) + this._emitQueue.length = 0 + for (var i = 0; i < eq.length; i ++) { + var e = eq[i] + this._emitMatch(e[0], e[1]) + } + } + if (this._processQueue.length) { + var pq = this._processQueue.slice(0) + this._processQueue.length = 0 + for (var i = 0; i < pq.length; i ++) { + var p = pq[i] + this._processing-- + this._process(p[0], p[1], p[2], p[3]) + } + } + } +} + +Glob.prototype._process = function (pattern, index, inGlobStar, cb) { + assert(this instanceof Glob) + assert(typeof cb === 'function') + + if (this.aborted) + return + + this._processing++ + if (this.paused) { + this._processQueue.push([pattern, index, inGlobStar, cb]) + return + } + + //console.error('PROCESS %d', this._processing, pattern) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // see if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index, cb) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip _processing + if (childrenIgnored(this, read)) + return cb() + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar, cb) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar, cb) +} + +Glob.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + return self._processReaddir2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + +Glob.prototype._processReaddir2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return cb() + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + //console.error('prd2', prefix, entries, remain[0]._glob, matchedEntries) + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return cb() + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this._emitMatch(index, e) + } + // This was the last one, and no stats were needed + return cb() + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) { + if (prefix !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + this._process([e].concat(remain), index, inGlobStar, cb) + } + cb() +} + +Glob.prototype._emitMatch = function (index, e) { + if (this.aborted) + return + + if (this.matches[index][e]) + return + + if (isIgnored(this, e)) + return + + if (this.paused) { + this._emitQueue.push([index, e]) + return + } + + var abs = this._makeAbs(e) + + if (this.nodir) { + var c = this.cache[abs] + if (c === 'DIR' || Array.isArray(c)) + return + } + + if (this.mark) + e = this._mark(e) + + this.matches[index][e] = true + + var st = this.statCache[abs] + if (st) + this.emit('stat', e, st) + + this.emit('match', e) +} + +Glob.prototype._readdirInGlobStar = function (abs, cb) { + if (this.aborted) + return + + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false, cb) + + var lstatkey = 'lstat\0' + abs + var self = this + var lstatcb = inflight(lstatkey, lstatcb_) + + if (lstatcb) + fs.lstat(abs, lstatcb) + + function lstatcb_ (er, lstat) { + if (er) + return cb() + + var isSym = lstat.isSymbolicLink() + self.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) { + self.cache[abs] = 'FILE' + cb() + } else + self._readdir(abs, false, cb) + } +} + +Glob.prototype._readdir = function (abs, inGlobStar, cb) { + if (this.aborted) + return + + cb = inflight('readdir\0'+abs+'\0'+inGlobStar, cb) + if (!cb) + return + + //console.error('RD %j %j', +inGlobStar, abs) + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs, cb) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return cb() + + if (Array.isArray(c)) + return cb(null, c) + } + + var self = this + fs.readdir(abs, readdirCb(this, abs, cb)) +} + +function readdirCb (self, abs, cb) { + return function (er, entries) { + if (er) + self._readdirError(abs, er, cb) + else + self._readdirEntries(abs, entries, cb) + } +} + +Glob.prototype._readdirEntries = function (abs, entries, cb) { + if (this.aborted) + return + + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + return cb(null, entries) +} + +Glob.prototype._readdirError = function (f, er, cb) { + if (this.aborted) + return + + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) { + this.emit('error', er) + // If the error is handled, then we abort + // if not, we threw out of here + this.abort() + } + if (!this.silent) + console.error('glob error', er) + break + } + + return cb() +} + +Glob.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar, cb) { + var self = this + this._readdir(abs, inGlobStar, function (er, entries) { + self._processGlobStar2(prefix, read, abs, remain, index, inGlobStar, entries, cb) + }) +} + + +Glob.prototype._processGlobStar2 = function (prefix, read, abs, remain, index, inGlobStar, entries, cb) { + //console.error('pgs2', prefix, remain[0], entries) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return cb() + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false, cb) + + var isSym = this.symlinks[abs] + var len = entries.length + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return cb() + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true, cb) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true, cb) + } + + cb() +} + +Glob.prototype._processSimple = function (prefix, index, cb) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var self = this + this._stat(prefix, function (er, exists) { + self._processSimple2(prefix, index, er, exists, cb) + }) +} +Glob.prototype._processSimple2 = function (prefix, index, er, exists, cb) { + + //console.error('ps2', prefix, exists) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return cb() + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this._emitMatch(index, prefix) + cb() +} + +// Returns either 'DIR', 'FILE', or false +Glob.prototype._stat = function (f, cb) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return cb() + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return cb(null, c) + + if (needDir && c === 'FILE') + return cb() + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (stat !== undefined) { + if (stat === false) + return cb(null, stat) + else { + var type = stat.isDirectory() ? 'DIR' : 'FILE' + if (needDir && type === 'FILE') + return cb() + else + return cb(null, type, stat) + } + } + + var self = this + var statcb = inflight('stat\0' + abs, lstatcb_) + if (statcb) + fs.lstat(abs, statcb) + + function lstatcb_ (er, lstat) { + if (lstat && lstat.isSymbolicLink()) { + // If it's a symlink, then treat it as the target, unless + // the target does not exist, then treat it as a file. + return fs.stat(abs, function (er, stat) { + if (er) + self._stat2(f, abs, null, lstat, cb) + else + self._stat2(f, abs, er, stat, cb) + }) + } else { + self._stat2(f, abs, er, lstat, cb) + } + } +} + +Glob.prototype._stat2 = function (f, abs, er, stat, cb) { + if (er) { + this.statCache[abs] = false + return cb() + } + + var needDir = f.slice(-1) === '/' + this.statCache[abs] = stat + + if (abs.slice(-1) === '/' && !stat.isDirectory()) + return cb(null, false, stat) + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return cb() + + return cb(null, c, stat) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./sync.js":17,"_process":24,"assert":9,"events":14,"fs":12,"inflight":18,"inherits":19,"minimatch":20,"once":21,"path":22,"path-is-absolute":23,"util":28}],17:[function(require,module,exports){ +(function (process){ +module.exports = globSync +globSync.GlobSync = GlobSync + +var fs = require('fs') +var minimatch = require('minimatch') +var Minimatch = minimatch.Minimatch +var Glob = require('./glob.js').Glob +var util = require('util') +var path = require('path') +var assert = require('assert') +var isAbsolute = require('path-is-absolute') +var common = require('./common.js') +var alphasort = common.alphasort +var alphasorti = common.alphasorti +var setopts = common.setopts +var ownProp = common.ownProp +var childrenIgnored = common.childrenIgnored + +function globSync (pattern, options) { + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + return new GlobSync(pattern, options).found +} + +function GlobSync (pattern, options) { + if (!pattern) + throw new Error('must provide pattern') + + if (typeof options === 'function' || arguments.length === 3) + throw new TypeError('callback provided to sync glob\n'+ + 'See: https://github.com/isaacs/node-glob/issues/167') + + if (!(this instanceof GlobSync)) + return new GlobSync(pattern, options) + + setopts(this, pattern, options) + + if (this.noprocess) + return this + + var n = this.minimatch.set.length + this.matches = new Array(n) + for (var i = 0; i < n; i ++) { + this._process(this.minimatch.set[i], i, false) + } + this._finish() +} + +GlobSync.prototype._finish = function () { + assert(this instanceof GlobSync) + if (this.realpath) { + var self = this + this.matches.forEach(function (matchset, index) { + var set = self.matches[index] = Object.create(null) + for (var p in matchset) { + try { + p = self._makeAbs(p) + var real = fs.realpathSync(p, self.realpathCache) + set[real] = true + } catch (er) { + if (er.syscall === 'stat') + set[self._makeAbs(p)] = true + else + throw er + } + } + }) + } + common.finish(this) +} + + +GlobSync.prototype._process = function (pattern, index, inGlobStar) { + assert(this instanceof GlobSync) + + // Get the first [n] parts of pattern that are all strings. + var n = 0 + while (typeof pattern[n] === 'string') { + n ++ + } + // now n is the index of the first one that is *not* a string. + + // See if there's anything else + var prefix + switch (n) { + // if not, then this is rather simple + case pattern.length: + this._processSimple(pattern.join('/'), index) + return + + case 0: + // pattern *starts* with some non-trivial item. + // going to readdir(cwd), but not include the prefix in matches. + prefix = null + break + + default: + // pattern has some string bits in the front. + // whatever it starts with, whether that's 'absolute' like /foo/bar, + // or 'relative' like '../baz' + prefix = pattern.slice(0, n).join('/') + break + } + + var remain = pattern.slice(n) + + // get the list of entries. + var read + if (prefix === null) + read = '.' + else if (isAbsolute(prefix) || isAbsolute(pattern.join('/'))) { + if (!prefix || !isAbsolute(prefix)) + prefix = '/' + prefix + read = prefix + } else + read = prefix + + var abs = this._makeAbs(read) + + //if ignored, skip processing + if (childrenIgnored(this, read)) + return + + var isGlobStar = remain[0] === minimatch.GLOBSTAR + if (isGlobStar) + this._processGlobStar(prefix, read, abs, remain, index, inGlobStar) + else + this._processReaddir(prefix, read, abs, remain, index, inGlobStar) +} + + +GlobSync.prototype._processReaddir = function (prefix, read, abs, remain, index, inGlobStar) { + var entries = this._readdir(abs, inGlobStar) + + // if the abs isn't a dir, then nothing can match! + if (!entries) + return + + // It will only match dot entries if it starts with a dot, or if + // dot is set. Stuff like @(.foo|.bar) isn't allowed. + var pn = remain[0] + var negate = !!this.minimatch.negate + var rawGlob = pn._glob + var dotOk = this.dot || rawGlob.charAt(0) === '.' + + var matchedEntries = [] + for (var i = 0; i < entries.length; i++) { + var e = entries[i] + if (e.charAt(0) !== '.' || dotOk) { + var m + if (negate && !prefix) { + m = !e.match(pn) + } else { + m = e.match(pn) + } + if (m) + matchedEntries.push(e) + } + } + + var len = matchedEntries.length + // If there are no matched entries, then nothing matches. + if (len === 0) + return + + // if this is the last remaining pattern bit, then no need for + // an additional stat *unless* the user has specified mark or + // stat explicitly. We know they exist, since readdir returned + // them. + + if (remain.length === 1 && !this.mark && !this.stat) { + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + if (prefix) { + if (prefix.slice(-1) !== '/') + e = prefix + '/' + e + else + e = prefix + e + } + + if (e.charAt(0) === '/' && !this.nomount) { + e = path.join(this.root, e) + } + this.matches[index][e] = true + } + // This was the last one, and no stats were needed + return + } + + // now test all matched entries as stand-ins for that part + // of the pattern. + remain.shift() + for (var i = 0; i < len; i ++) { + var e = matchedEntries[i] + var newPattern + if (prefix) + newPattern = [prefix, e] + else + newPattern = [e] + this._process(newPattern.concat(remain), index, inGlobStar) + } +} + + +GlobSync.prototype._emitMatch = function (index, e) { + var abs = this._makeAbs(e) + if (this.mark) + e = this._mark(e) + + if (this.matches[index][e]) + return + + if (this.nodir) { + var c = this.cache[this._makeAbs(e)] + if (c === 'DIR' || Array.isArray(c)) + return + } + + this.matches[index][e] = true + if (this.stat) + this._stat(e) +} + + +GlobSync.prototype._readdirInGlobStar = function (abs) { + // follow all symlinked directories forever + // just proceed as if this is a non-globstar situation + if (this.follow) + return this._readdir(abs, false) + + var entries + var lstat + var stat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + // lstat failed, doesn't exist + return null + } + + var isSym = lstat.isSymbolicLink() + this.symlinks[abs] = isSym + + // If it's not a symlink or a dir, then it's definitely a regular file. + // don't bother doing a readdir in that case. + if (!isSym && !lstat.isDirectory()) + this.cache[abs] = 'FILE' + else + entries = this._readdir(abs, false) + + return entries +} + +GlobSync.prototype._readdir = function (abs, inGlobStar) { + var entries + + if (inGlobStar && !ownProp(this.symlinks, abs)) + return this._readdirInGlobStar(abs) + + if (ownProp(this.cache, abs)) { + var c = this.cache[abs] + if (!c || c === 'FILE') + return null + + if (Array.isArray(c)) + return c + } + + try { + return this._readdirEntries(abs, fs.readdirSync(abs)) + } catch (er) { + this._readdirError(abs, er) + return null + } +} + +GlobSync.prototype._readdirEntries = function (abs, entries) { + // if we haven't asked to stat everything, then just + // assume that everything in there exists, so we can avoid + // having to stat it a second time. + if (!this.mark && !this.stat) { + for (var i = 0; i < entries.length; i ++) { + var e = entries[i] + if (abs === '/') + e = abs + e + else + e = abs + '/' + e + this.cache[e] = true + } + } + + this.cache[abs] = entries + + // mark and cache dir-ness + return entries +} + +GlobSync.prototype._readdirError = function (f, er) { + // handle errors, and cache the information + switch (er.code) { + case 'ENOTSUP': // https://github.com/isaacs/node-glob/issues/205 + case 'ENOTDIR': // totally normal. means it *does* exist. + this.cache[this._makeAbs(f)] = 'FILE' + break + + case 'ENOENT': // not terribly unusual + case 'ELOOP': + case 'ENAMETOOLONG': + case 'UNKNOWN': + this.cache[this._makeAbs(f)] = false + break + + default: // some unusual error. Treat as failure. + this.cache[this._makeAbs(f)] = false + if (this.strict) + throw er + if (!this.silent) + console.error('glob error', er) + break + } +} + +GlobSync.prototype._processGlobStar = function (prefix, read, abs, remain, index, inGlobStar) { + + var entries = this._readdir(abs, inGlobStar) + + // no entries means not a dir, so it can never have matches + // foo.txt/** doesn't match foo.txt + if (!entries) + return + + // test without the globstar, and with every child both below + // and replacing the globstar. + var remainWithoutGlobStar = remain.slice(1) + var gspref = prefix ? [ prefix ] : [] + var noGlobStar = gspref.concat(remainWithoutGlobStar) + + // the noGlobStar pattern exits the inGlobStar state + this._process(noGlobStar, index, false) + + var len = entries.length + var isSym = this.symlinks[abs] + + // If it's a symlink, and we're in a globstar, then stop + if (isSym && inGlobStar) + return + + for (var i = 0; i < len; i++) { + var e = entries[i] + if (e.charAt(0) === '.' && !this.dot) + continue + + // these two cases enter the inGlobStar state + var instead = gspref.concat(entries[i], remainWithoutGlobStar) + this._process(instead, index, true) + + var below = gspref.concat(entries[i], remain) + this._process(below, index, true) + } +} + +GlobSync.prototype._processSimple = function (prefix, index) { + // XXX review this. Shouldn't it be doing the mounting etc + // before doing stat? kinda weird? + var exists = this._stat(prefix) + + if (!this.matches[index]) + this.matches[index] = Object.create(null) + + // If it doesn't exist, then just mark the lack of results + if (!exists) + return + + if (prefix && isAbsolute(prefix) && !this.nomount) { + var trail = /[\/\\]$/.test(prefix) + if (prefix.charAt(0) === '/') { + prefix = path.join(this.root, prefix) + } else { + prefix = path.resolve(this.root, prefix) + if (trail) + prefix += '/' + } + } + + if (process.platform === 'win32') + prefix = prefix.replace(/\\/g, '/') + + // Mark this as a match + this.matches[index][prefix] = true +} + +// Returns either 'DIR', 'FILE', or false +GlobSync.prototype._stat = function (f) { + var abs = this._makeAbs(f) + var needDir = f.slice(-1) === '/' + + if (f.length > this.maxLength) + return false + + if (!this.stat && ownProp(this.cache, abs)) { + var c = this.cache[abs] + + if (Array.isArray(c)) + c = 'DIR' + + // It exists, but maybe not how we need it + if (!needDir || c === 'DIR') + return c + + if (needDir && c === 'FILE') + return false + + // otherwise we have to stat, because maybe c=true + // if we know it exists, but not what it is. + } + + var exists + var stat = this.statCache[abs] + if (!stat) { + var lstat + try { + lstat = fs.lstatSync(abs) + } catch (er) { + return false + } + + if (lstat.isSymbolicLink()) { + try { + stat = fs.statSync(abs) + } catch (er) { + stat = lstat + } + } else { + stat = lstat + } + } + + this.statCache[abs] = stat + + var c = stat.isDirectory() ? 'DIR' : 'FILE' + this.cache[abs] = this.cache[abs] || c + + if (needDir && c !== 'DIR') + return false + + return c +} + +GlobSync.prototype._mark = function (p) { + return common.mark(this, p) +} + +GlobSync.prototype._makeAbs = function (f) { + return common.makeAbs(this, f) +} + +}).call(this,require('_process')) +},{"./common.js":15,"./glob.js":16,"_process":24,"assert":9,"fs":12,"minimatch":20,"path":22,"path-is-absolute":23,"util":28}],18:[function(require,module,exports){ +(function (process){ +var wrappy = require('wrappy') +var reqs = Object.create(null) +var once = require('once') + +module.exports = wrappy(inflight) + +function inflight (key, cb) { + if (reqs[key]) { + reqs[key].push(cb) + return null + } else { + reqs[key] = [cb] + return makeres(key) + } +} + +function makeres (key) { + return once(function RES () { + var cbs = reqs[key] + var len = cbs.length + var args = slice(arguments) + + // XXX It's somewhat ambiguous whether a new callback added in this + // pass should be queued for later execution if something in the + // list of callbacks throws, or if it should just be discarded. + // However, it's such an edge case that it hardly matters, and either + // choice is likely as surprising as the other. + // As it happens, we do go ahead and schedule it for later execution. + try { + for (var i = 0; i < len; i++) { + cbs[i].apply(null, args) + } + } finally { + if (cbs.length > len) { + // added more in the interim. + // de-zalgo, just in case, but don't call again. + cbs.splice(0, len) + process.nextTick(function () { + RES.apply(null, args) + }) + } else { + delete reqs[key] + } + } + }) +} + +function slice (args) { + var length = args.length + var array = [] + + for (var i = 0; i < length; i++) array[i] = args[i] + return array +} + +}).call(this,require('_process')) +},{"_process":24,"once":21,"wrappy":29}],19:[function(require,module,exports){ +if (typeof Object.create === 'function') { + // implementation from standard node.js 'util' module + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + ctor.prototype = Object.create(superCtor.prototype, { + constructor: { + value: ctor, + enumerable: false, + writable: true, + configurable: true + } + }); + }; +} else { + // old school shim for old browsers + module.exports = function inherits(ctor, superCtor) { + ctor.super_ = superCtor + var TempCtor = function () {} + TempCtor.prototype = superCtor.prototype + ctor.prototype = new TempCtor() + ctor.prototype.constructor = ctor + } +} + +},{}],20:[function(require,module,exports){ +module.exports = minimatch +minimatch.Minimatch = Minimatch + +var path = { sep: '/' } +try { + path = require('path') +} catch (er) {} + +var GLOBSTAR = minimatch.GLOBSTAR = Minimatch.GLOBSTAR = {} +var expand = require('brace-expansion') + +var plTypes = { + '!': { open: '(?:(?!(?:', close: '))[^/]*?)'}, + '?': { open: '(?:', close: ')?' }, + '+': { open: '(?:', close: ')+' }, + '*': { open: '(?:', close: ')*' }, + '@': { open: '(?:', close: ')' } +} + +// any single thing other than / +// don't need to escape / when using new RegExp() +var qmark = '[^/]' + +// * => any number of characters +var star = qmark + '*?' + +// ** when dots are allowed. Anything goes, except .. and . +// not (^ or / followed by one or two dots followed by $ or /), +// followed by anything, any number of times. +var twoStarDot = '(?:(?!(?:\\\/|^)(?:\\.{1,2})($|\\\/)).)*?' + +// not a ^ or / followed by a dot, +// followed by anything, any number of times. +var twoStarNoDot = '(?:(?!(?:\\\/|^)\\.).)*?' + +// characters that need to be escaped in RegExp. +var reSpecials = charSet('().*{}+?[]^$\\!') + +// "abc" -> { a:true, b:true, c:true } +function charSet (s) { + return s.split('').reduce(function (set, c) { + set[c] = true + return set + }, {}) +} + +// normalizes slashes. +var slashSplit = /\/+/ + +minimatch.filter = filter +function filter (pattern, options) { + options = options || {} + return function (p, i, list) { + return minimatch(p, pattern, options) + } +} + +function ext (a, b) { + a = a || {} + b = b || {} + var t = {} + Object.keys(b).forEach(function (k) { + t[k] = b[k] + }) + Object.keys(a).forEach(function (k) { + t[k] = a[k] + }) + return t +} + +minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return minimatch + + var orig = minimatch + + var m = function minimatch (p, pattern, options) { + return orig.minimatch(p, pattern, ext(def, options)) + } + + m.Minimatch = function Minimatch (pattern, options) { + return new orig.Minimatch(pattern, ext(def, options)) + } + + return m +} + +Minimatch.defaults = function (def) { + if (!def || !Object.keys(def).length) return Minimatch + return minimatch.defaults(def).Minimatch +} + +function minimatch (p, pattern, options) { + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + + // shortcut: comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + return false + } + + // "" only matches "" + if (pattern.trim() === '') return p === '' + + return new Minimatch(pattern, options).match(p) +} + +function Minimatch (pattern, options) { + if (!(this instanceof Minimatch)) { + return new Minimatch(pattern, options) + } + + if (typeof pattern !== 'string') { + throw new TypeError('glob pattern string required') + } + + if (!options) options = {} + pattern = pattern.trim() + + // windows support: need to use /, not \ + if (path.sep !== '/') { + pattern = pattern.split(path.sep).join('/') + } + + this.options = options + this.set = [] + this.pattern = pattern + this.regexp = null + this.negate = false + this.comment = false + this.empty = false + + // make the set of regexps etc. + this.make() +} + +Minimatch.prototype.debug = function () {} + +Minimatch.prototype.make = make +function make () { + // don't do it more than once. + if (this._made) return + + var pattern = this.pattern + var options = this.options + + // empty patterns and comments match nothing. + if (!options.nocomment && pattern.charAt(0) === '#') { + this.comment = true + return + } + if (!pattern) { + this.empty = true + return + } + + // step 1: figure out negation, etc. + this.parseNegate() + + // step 2: expand braces + var set = this.globSet = this.braceExpand() + + if (options.debug) this.debug = console.error + + this.debug(this.pattern, set) + + // step 3: now we have a set, so turn each one into a series of path-portion + // matching patterns. + // These will be regexps, except in the case of "**", which is + // set to the GLOBSTAR object for globstar behavior, + // and will not contain any / characters + set = this.globParts = set.map(function (s) { + return s.split(slashSplit) + }) + + this.debug(this.pattern, set) + + // glob --> regexps + set = set.map(function (s, si, set) { + return s.map(this.parse, this) + }, this) + + this.debug(this.pattern, set) + + // filter out everything that didn't compile properly. + set = set.filter(function (s) { + return s.indexOf(false) === -1 + }) + + this.debug(this.pattern, set) + + this.set = set +} + +Minimatch.prototype.parseNegate = parseNegate +function parseNegate () { + var pattern = this.pattern + var negate = false + var options = this.options + var negateOffset = 0 + + if (options.nonegate) return + + for (var i = 0, l = pattern.length + ; i < l && pattern.charAt(i) === '!' + ; i++) { + negate = !negate + negateOffset++ + } + + if (negateOffset) this.pattern = pattern.substr(negateOffset) + this.negate = negate +} + +// Brace expansion: +// a{b,c}d -> abd acd +// a{b,}c -> abc ac +// a{0..3}d -> a0d a1d a2d a3d +// a{b,c{d,e}f}g -> abg acdfg acefg +// a{b,c}d{e,f}g -> abdeg acdeg abdeg abdfg +// +// Invalid sets are not expanded. +// a{2..}b -> a{2..}b +// a{b}c -> a{b}c +minimatch.braceExpand = function (pattern, options) { + return braceExpand(pattern, options) +} + +Minimatch.prototype.braceExpand = braceExpand + +function braceExpand (pattern, options) { + if (!options) { + if (this instanceof Minimatch) { + options = this.options + } else { + options = {} + } + } + + pattern = typeof pattern === 'undefined' + ? this.pattern : pattern + + if (typeof pattern === 'undefined') { + throw new TypeError('undefined pattern') + } + + if (options.nobrace || + !pattern.match(/\{.*\}/)) { + // shortcut. no need to expand. + return [pattern] + } + + return expand(pattern) +} + +// parse a component of the expanded set. +// At this point, no pattern may contain "/" in it +// so we're going to return a 2d array, where each entry is the full +// pattern, split on '/', and then turned into a regular expression. +// A regexp is made at the end which joins each array with an +// escaped /, and another full one which joins each regexp with |. +// +// Following the lead of Bash 4.1, note that "**" only has special meaning +// when it is the *only* thing in a path portion. Otherwise, any series +// of * is equivalent to a single *. Globstar behavior is enabled by +// default, and can be disabled by setting options.noglobstar. +Minimatch.prototype.parse = parse +var SUBPARSE = {} +function parse (pattern, isSub) { + if (pattern.length > 1024 * 64) { + throw new TypeError('pattern is too long') + } + + var options = this.options + + // shortcuts + if (!options.noglobstar && pattern === '**') return GLOBSTAR + if (pattern === '') return '' + + var re = '' + var hasMagic = !!options.nocase + var escaping = false + // ? => one single character + var patternListStack = [] + var negativeLists = [] + var stateChar + var inClass = false + var reClassStart = -1 + var classStart = -1 + // . and .. never match anything that doesn't start with ., + // even when options.dot is set. + var patternStart = pattern.charAt(0) === '.' ? '' // anything + // not (start or / followed by . or .. followed by / or end) + : options.dot ? '(?!(?:^|\\\/)\\.{1,2}(?:$|\\\/))' + : '(?!\\.)' + var self = this + + function clearStateChar () { + if (stateChar) { + // we had some state-tracking character + // that wasn't consumed by this pass. + switch (stateChar) { + case '*': + re += star + hasMagic = true + break + case '?': + re += qmark + hasMagic = true + break + default: + re += '\\' + stateChar + break + } + self.debug('clearStateChar %j %j', stateChar, re) + stateChar = false + } + } + + for (var i = 0, len = pattern.length, c + ; (i < len) && (c = pattern.charAt(i)) + ; i++) { + this.debug('%s\t%s %s %j', pattern, i, re, c) + + // skip over any that are escaped. + if (escaping && reSpecials[c]) { + re += '\\' + c + escaping = false + continue + } + + switch (c) { + case '/': + // completely not allowed, even escaped. + // Should already be path-split by now. + return false + + case '\\': + clearStateChar() + escaping = true + continue + + // the various stateChar values + // for the "extglob" stuff. + case '?': + case '*': + case '+': + case '@': + case '!': + this.debug('%s\t%s %s %j <-- stateChar', pattern, i, re, c) + + // all of those are literals inside a class, except that + // the glob [!a] means [^a] in regexp + if (inClass) { + this.debug(' in class') + if (c === '!' && i === classStart + 1) c = '^' + re += c + continue + } + + // if we already have a stateChar, then it means + // that there was something like ** or +? in there. + // Handle the stateChar, then proceed with this one. + self.debug('call clearStateChar %j', stateChar) + clearStateChar() + stateChar = c + // if extglob is disabled, then +(asdf|foo) isn't a thing. + // just clear the statechar *now*, rather than even diving into + // the patternList stuff. + if (options.noext) clearStateChar() + continue + + case '(': + if (inClass) { + re += '(' + continue + } + + if (!stateChar) { + re += '\\(' + continue + } + + patternListStack.push({ + type: stateChar, + start: i - 1, + reStart: re.length, + open: plTypes[stateChar].open, + close: plTypes[stateChar].close + }) + // negation is (?:(?!js)[^/]*) + re += stateChar === '!' ? '(?:(?!(?:' : '(?:' + this.debug('plType %j %j', stateChar, re) + stateChar = false + continue + + case ')': + if (inClass || !patternListStack.length) { + re += '\\)' + continue + } + + clearStateChar() + hasMagic = true + var pl = patternListStack.pop() + // negation is (?:(?!js)[^/]*) + // The others are (?:) + re += pl.close + if (pl.type === '!') { + negativeLists.push(pl) + } + pl.reEnd = re.length + continue + + case '|': + if (inClass || !patternListStack.length || escaping) { + re += '\\|' + escaping = false + continue + } + + clearStateChar() + re += '|' + continue + + // these are mostly the same in regexp and glob + case '[': + // swallow any state-tracking char before the [ + clearStateChar() + + if (inClass) { + re += '\\' + c + continue + } + + inClass = true + classStart = i + reClassStart = re.length + re += c + continue + + case ']': + // a right bracket shall lose its special + // meaning and represent itself in + // a bracket expression if it occurs + // first in the list. -- POSIX.2 2.8.3.2 + if (i === classStart + 1 || !inClass) { + re += '\\' + c + escaping = false + continue + } + + // handle the case where we left a class open. + // "[z-a]" is valid, equivalent to "\[z-a\]" + if (inClass) { + // split where the last [ was, make sure we don't have + // an invalid re. if so, re-walk the contents of the + // would-be class to re-translate any characters that + // were passed through as-is + // TODO: It would probably be faster to determine this + // without a try/catch and a new RegExp, but it's tricky + // to do safely. For now, this is safe and works. + var cs = pattern.substring(classStart + 1, i) + try { + RegExp('[' + cs + ']') + } catch (er) { + // not a valid class! + var sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + '\\]' + hasMagic = hasMagic || sp[1] + inClass = false + continue + } + } + + // finish up the class. + hasMagic = true + inClass = false + re += c + continue + + default: + // swallow any state char that wasn't consumed + clearStateChar() + + if (escaping) { + // no need + escaping = false + } else if (reSpecials[c] + && !(c === '^' && inClass)) { + re += '\\' + } + + re += c + + } // switch + } // for + + // handle the case where we left a class open. + // "[abc" is valid, equivalent to "\[abc" + if (inClass) { + // split where the last [ was, and escape it + // this is a huge pita. We now have to re-walk + // the contents of the would-be class to re-translate + // any characters that were passed through as-is + cs = pattern.substr(classStart + 1) + sp = this.parse(cs, SUBPARSE) + re = re.substr(0, reClassStart) + '\\[' + sp[0] + hasMagic = hasMagic || sp[1] + } + + // handle the case where we had a +( thing at the *end* + // of the pattern. + // each pattern list stack adds 3 chars, and we need to go through + // and escape any | chars that were passed through as-is for the regexp. + // Go through and escape them, taking care not to double-escape any + // | chars that were already escaped. + for (pl = patternListStack.pop(); pl; pl = patternListStack.pop()) { + var tail = re.slice(pl.reStart + pl.open.length) + this.debug('setting tail', re, pl) + // maybe some even number of \, then maybe 1 \, followed by a | + tail = tail.replace(/((?:\\{2}){0,64})(\\?)\|/g, function (_, $1, $2) { + if (!$2) { + // the | isn't already escaped, so escape it. + $2 = '\\' + } + + // need to escape all those slashes *again*, without escaping the + // one that we need for escaping the | character. As it works out, + // escaping an even number of slashes can be done by simply repeating + // it exactly after itself. That's why this trick works. + // + // I am sorry that you have to see this. + return $1 + $1 + $2 + '|' + }) + + this.debug('tail=%j\n %s', tail, tail, pl, re) + var t = pl.type === '*' ? star + : pl.type === '?' ? qmark + : '\\' + pl.type + + hasMagic = true + re = re.slice(0, pl.reStart) + t + '\\(' + tail + } + + // handle trailing things that only matter at the very end. + clearStateChar() + if (escaping) { + // trailing \\ + re += '\\\\' + } + + // only need to apply the nodot start if the re starts with + // something that could conceivably capture a dot + var addPatternStart = false + switch (re.charAt(0)) { + case '.': + case '[': + case '(': addPatternStart = true + } + + // Hack to work around lack of negative lookbehind in JS + // A pattern like: *.!(x).!(y|z) needs to ensure that a name + // like 'a.xyz.yz' doesn't match. So, the first negative + // lookahead, has to look ALL the way ahead, to the end of + // the pattern. + for (var n = negativeLists.length - 1; n > -1; n--) { + var nl = negativeLists[n] + + var nlBefore = re.slice(0, nl.reStart) + var nlFirst = re.slice(nl.reStart, nl.reEnd - 8) + var nlLast = re.slice(nl.reEnd - 8, nl.reEnd) + var nlAfter = re.slice(nl.reEnd) + + nlLast += nlAfter + + // Handle nested stuff like *(*.js|!(*.json)), where open parens + // mean that we should *not* include the ) in the bit that is considered + // "after" the negated section. + var openParensBefore = nlBefore.split('(').length - 1 + var cleanAfter = nlAfter + for (i = 0; i < openParensBefore; i++) { + cleanAfter = cleanAfter.replace(/\)[+*?]?/, '') + } + nlAfter = cleanAfter + + var dollar = '' + if (nlAfter === '' && isSub !== SUBPARSE) { + dollar = '$' + } + var newRe = nlBefore + nlFirst + nlAfter + dollar + nlLast + re = newRe + } + + // if the re is not "" at this point, then we need to make sure + // it doesn't match against an empty path part. + // Otherwise a/* will match a/, which it should not. + if (re !== '' && hasMagic) { + re = '(?=.)' + re + } + + if (addPatternStart) { + re = patternStart + re + } + + // parsing just a piece of a larger pattern. + if (isSub === SUBPARSE) { + return [re, hasMagic] + } + + // skip the regexp for non-magical patterns + // unescape anything in it, though, so that it'll be + // an exact match against a file etc. + if (!hasMagic) { + return globUnescape(pattern) + } + + var flags = options.nocase ? 'i' : '' + try { + var regExp = new RegExp('^' + re + '$', flags) + } catch (er) { + // If it was an invalid regular expression, then it can't match + // anything. This trick looks for a character after the end of + // the string, which is of course impossible, except in multi-line + // mode, but it's not a /m regex. + return new RegExp('$.') + } + + regExp._glob = pattern + regExp._src = re + + return regExp +} + +minimatch.makeRe = function (pattern, options) { + return new Minimatch(pattern, options || {}).makeRe() +} + +Minimatch.prototype.makeRe = makeRe +function makeRe () { + if (this.regexp || this.regexp === false) return this.regexp + + // at this point, this.set is a 2d array of partial + // pattern strings, or "**". + // + // It's better to use .match(). This function shouldn't + // be used, really, but it's pretty convenient sometimes, + // when you just want to work with a regex. + var set = this.set + + if (!set.length) { + this.regexp = false + return this.regexp + } + var options = this.options + + var twoStar = options.noglobstar ? star + : options.dot ? twoStarDot + : twoStarNoDot + var flags = options.nocase ? 'i' : '' + + var re = set.map(function (pattern) { + return pattern.map(function (p) { + return (p === GLOBSTAR) ? twoStar + : (typeof p === 'string') ? regExpEscape(p) + : p._src + }).join('\\\/') + }).join('|') + + // must match entire pattern + // ending in a * or ** will make it less strict. + re = '^(?:' + re + ')$' + + // can match anything, as long as it's not this. + if (this.negate) re = '^(?!' + re + ').*$' + + try { + this.regexp = new RegExp(re, flags) + } catch (ex) { + this.regexp = false + } + return this.regexp +} + +minimatch.match = function (list, pattern, options) { + options = options || {} + var mm = new Minimatch(pattern, options) + list = list.filter(function (f) { + return mm.match(f) + }) + if (mm.options.nonull && !list.length) { + list.push(pattern) + } + return list +} + +Minimatch.prototype.match = match +function match (f, partial) { + this.debug('match', f, this.pattern) + // short-circuit in the case of busted things. + // comments, etc. + if (this.comment) return false + if (this.empty) return f === '' + + if (f === '/' && partial) return true + + var options = this.options + + // windows: need to use /, not \ + if (path.sep !== '/') { + f = f.split(path.sep).join('/') + } + + // treat the test path as a set of pathparts. + f = f.split(slashSplit) + this.debug(this.pattern, 'split', f) + + // just ONE of the pattern sets in this.set needs to match + // in order for it to be valid. If negating, then just one + // match means that we have failed. + // Either way, return on the first hit. + + var set = this.set + this.debug(this.pattern, 'set', set) + + // Find the basename of the path by looking for the last non-empty segment + var filename + var i + for (i = f.length - 1; i >= 0; i--) { + filename = f[i] + if (filename) break + } + + for (i = 0; i < set.length; i++) { + var pattern = set[i] + var file = f + if (options.matchBase && pattern.length === 1) { + file = [filename] + } + var hit = this.matchOne(file, pattern, partial) + if (hit) { + if (options.flipNegate) return true + return !this.negate + } + } + + // didn't get any hits. this is success if it's a negative + // pattern, failure otherwise. + if (options.flipNegate) return false + return this.negate +} + +// set partial to true to test if, for example, +// "/a/b" matches the start of "/*/b/*/d" +// Partial means, if you run out of file before you run +// out of pattern, then that's fine, as long as all +// the parts match. +Minimatch.prototype.matchOne = function (file, pattern, partial) { + var options = this.options + + this.debug('matchOne', + { 'this': this, file: file, pattern: pattern }) + + this.debug('matchOne', file.length, pattern.length) + + for (var fi = 0, + pi = 0, + fl = file.length, + pl = pattern.length + ; (fi < fl) && (pi < pl) + ; fi++, pi++) { + this.debug('matchOne loop') + var p = pattern[pi] + var f = file[fi] + + this.debug(pattern, p, f) + + // should be impossible. + // some invalid regexp stuff in the set. + if (p === false) return false + + if (p === GLOBSTAR) { + this.debug('GLOBSTAR', [pattern, p, f]) + + // "**" + // a/**/b/**/c would match the following: + // a/b/x/y/z/c + // a/x/y/z/b/c + // a/b/x/b/x/c + // a/b/c + // To do this, take the rest of the pattern after + // the **, and see if it would match the file remainder. + // If so, return success. + // If not, the ** "swallows" a segment, and try again. + // This is recursively awful. + // + // a/**/b/**/c matching a/b/x/y/z/c + // - a matches a + // - doublestar + // - matchOne(b/x/y/z/c, b/**/c) + // - b matches b + // - doublestar + // - matchOne(x/y/z/c, c) -> no + // - matchOne(y/z/c, c) -> no + // - matchOne(z/c, c) -> no + // - matchOne(c, c) yes, hit + var fr = fi + var pr = pi + 1 + if (pr === pl) { + this.debug('** at the end') + // a ** at the end will just swallow the rest. + // We have found a match. + // however, it will not swallow /.x, unless + // options.dot is set. + // . and .. are *never* matched by **, for explosively + // exponential reasons. + for (; fi < fl; fi++) { + if (file[fi] === '.' || file[fi] === '..' || + (!options.dot && file[fi].charAt(0) === '.')) return false + } + return true + } + + // ok, let's see if we can swallow whatever we can. + while (fr < fl) { + var swallowee = file[fr] + + this.debug('\nglobstar while', file, fr, pattern, pr, swallowee) + + // XXX remove this slice. Just pass the start index. + if (this.matchOne(file.slice(fr), pattern.slice(pr), partial)) { + this.debug('globstar found match!', fr, fl, swallowee) + // found a match. + return true + } else { + // can't swallow "." or ".." ever. + // can only swallow ".foo" when explicitly asked. + if (swallowee === '.' || swallowee === '..' || + (!options.dot && swallowee.charAt(0) === '.')) { + this.debug('dot detected!', file, fr, pattern, pr) + break + } + + // ** swallows a segment, and continue. + this.debug('globstar swallow a segment, and continue') + fr++ + } + } + + // no match was found. + // However, in partial mode, we can't say this is necessarily over. + // If there's more *pattern* left, then + if (partial) { + // ran out of file + this.debug('\n>>> no match, partial?', file, fr, pattern, pr) + if (fr === fl) return true + } + return false + } + + // something other than ** + // non-magic patterns just have to match exactly + // patterns with magic have been turned into regexps. + var hit + if (typeof p === 'string') { + if (options.nocase) { + hit = f.toLowerCase() === p.toLowerCase() + } else { + hit = f === p + } + this.debug('string match', p, f, hit) + } else { + hit = f.match(p) + this.debug('pattern match', p, f, hit) + } + + if (!hit) return false + } + + // Note: ending in / means that we'll get a final "" + // at the end of the pattern. This can only match a + // corresponding "" at the end of the file. + // If the file ends in /, then it can only match a + // a pattern that ends in /, unless the pattern just + // doesn't have any more for it. But, a/b/ should *not* + // match "a/b/*", even though "" matches against the + // [^/]*? pattern, except in partial mode, where it might + // simply not be reached yet. + // However, a/b/ should still satisfy a/* + + // now either we fell off the end of the pattern, or we're done. + if (fi === fl && pi === pl) { + // ran out of pattern and filename at the same time. + // an exact hit! + return true + } else if (fi === fl) { + // ran out of file, but still had pattern left. + // this is ok if we're doing the match as part of + // a glob fs traversal. + return partial + } else if (pi === pl) { + // ran out of pattern, still have file left. + // this is only acceptable if we're on the very last + // empty segment of a file with a trailing slash. + // a/* should match a/b/ + var emptyFileEnd = (fi === fl - 1) && (file[fi] === '') + return emptyFileEnd + } + + // should be unreachable. + throw new Error('wtf?') +} + +// replace stuff like \* with * +function globUnescape (s) { + return s.replace(/\\(.)/g, '$1') +} + +function regExpEscape (s) { + return s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&') +} + +},{"brace-expansion":11,"path":22}],21:[function(require,module,exports){ +var wrappy = require('wrappy') +module.exports = wrappy(once) +module.exports.strict = wrappy(onceStrict) + +once.proto = once(function () { + Object.defineProperty(Function.prototype, 'once', { + value: function () { + return once(this) + }, + configurable: true + }) + + Object.defineProperty(Function.prototype, 'onceStrict', { + value: function () { + return onceStrict(this) + }, + configurable: true + }) +}) + +function once (fn) { + var f = function () { + if (f.called) return f.value + f.called = true + return f.value = fn.apply(this, arguments) + } + f.called = false + return f +} + +function onceStrict (fn) { + var f = function () { + if (f.called) + throw new Error(f.onceError) + f.called = true + return f.value = fn.apply(this, arguments) + } + var name = fn.name || 'Function wrapped with `once`' + f.onceError = name + " shouldn't be called more than once" + f.called = false + return f +} + +},{"wrappy":29}],22:[function(require,module,exports){ +(function (process){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +// resolves . and .. elements in a path array with directory names there +// must be no slashes, empty elements, or device names (c:\) in the array +// (so also no leading and trailing slashes - it does not distinguish +// relative and absolute paths) +function normalizeArray(parts, allowAboveRoot) { + // if the path tries to go above the root, `up` ends up > 0 + var up = 0; + for (var i = parts.length - 1; i >= 0; i--) { + var last = parts[i]; + if (last === '.') { + parts.splice(i, 1); + } else if (last === '..') { + parts.splice(i, 1); + up++; + } else if (up) { + parts.splice(i, 1); + up--; + } + } + + // if the path is allowed to go above the root, restore leading ..s + if (allowAboveRoot) { + for (; up--; up) { + parts.unshift('..'); + } + } + + return parts; +} + +// Split a filename into [root, dir, basename, ext], unix version +// 'root' is just a slash, or nothing. +var splitPathRe = + /^(\/?|)([\s\S]*?)((?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/; +var splitPath = function(filename) { + return splitPathRe.exec(filename).slice(1); +}; + +// path.resolve([from ...], to) +// posix version +exports.resolve = function() { + var resolvedPath = '', + resolvedAbsolute = false; + + for (var i = arguments.length - 1; i >= -1 && !resolvedAbsolute; i--) { + var path = (i >= 0) ? arguments[i] : process.cwd(); + + // Skip empty and invalid entries + if (typeof path !== 'string') { + throw new TypeError('Arguments to path.resolve must be strings'); + } else if (!path) { + continue; + } + + resolvedPath = path + '/' + resolvedPath; + resolvedAbsolute = path.charAt(0) === '/'; + } + + // At this point the path should be resolved to a full absolute path, but + // handle relative paths to be safe (might happen when process.cwd() fails) + + // Normalize the path + resolvedPath = normalizeArray(filter(resolvedPath.split('/'), function(p) { + return !!p; + }), !resolvedAbsolute).join('/'); + + return ((resolvedAbsolute ? '/' : '') + resolvedPath) || '.'; +}; + +// path.normalize(path) +// posix version +exports.normalize = function(path) { + var isAbsolute = exports.isAbsolute(path), + trailingSlash = substr(path, -1) === '/'; + + // Normalize the path + path = normalizeArray(filter(path.split('/'), function(p) { + return !!p; + }), !isAbsolute).join('/'); + + if (!path && !isAbsolute) { + path = '.'; + } + if (path && trailingSlash) { + path += '/'; + } + + return (isAbsolute ? '/' : '') + path; +}; + +// posix version +exports.isAbsolute = function(path) { + return path.charAt(0) === '/'; +}; + +// posix version +exports.join = function() { + var paths = Array.prototype.slice.call(arguments, 0); + return exports.normalize(filter(paths, function(p, index) { + if (typeof p !== 'string') { + throw new TypeError('Arguments to path.join must be strings'); + } + return p; + }).join('/')); +}; + + +// path.relative(from, to) +// posix version +exports.relative = function(from, to) { + from = exports.resolve(from).substr(1); + to = exports.resolve(to).substr(1); + + function trim(arr) { + var start = 0; + for (; start < arr.length; start++) { + if (arr[start] !== '') break; + } + + var end = arr.length - 1; + for (; end >= 0; end--) { + if (arr[end] !== '') break; + } + + if (start > end) return []; + return arr.slice(start, end - start + 1); + } + + var fromParts = trim(from.split('/')); + var toParts = trim(to.split('/')); + + var length = Math.min(fromParts.length, toParts.length); + var samePartsLength = length; + for (var i = 0; i < length; i++) { + if (fromParts[i] !== toParts[i]) { + samePartsLength = i; + break; + } + } + + var outputParts = []; + for (var i = samePartsLength; i < fromParts.length; i++) { + outputParts.push('..'); + } + + outputParts = outputParts.concat(toParts.slice(samePartsLength)); + + return outputParts.join('/'); +}; + +exports.sep = '/'; +exports.delimiter = ':'; + +exports.dirname = function(path) { + var result = splitPath(path), + root = result[0], + dir = result[1]; + + if (!root && !dir) { + // No dirname whatsoever + return '.'; + } + + if (dir) { + // It has a dirname, strip trailing slash + dir = dir.substr(0, dir.length - 1); + } + + return root + dir; +}; + + +exports.basename = function(path, ext) { + var f = splitPath(path)[2]; + // TODO: make this comparison case-insensitive on windows? + if (ext && f.substr(-1 * ext.length) === ext) { + f = f.substr(0, f.length - ext.length); + } + return f; +}; + + +exports.extname = function(path) { + return splitPath(path)[3]; +}; + +function filter (xs, f) { + if (xs.filter) return xs.filter(f); + var res = []; + for (var i = 0; i < xs.length; i++) { + if (f(xs[i], i, xs)) res.push(xs[i]); + } + return res; +} + +// String.prototype.substr - negative index don't work in IE8 +var substr = 'ab'.substr(-1) === 'b' + ? function (str, start, len) { return str.substr(start, len) } + : function (str, start, len) { + if (start < 0) start = str.length + start; + return str.substr(start, len); + } +; + +}).call(this,require('_process')) +},{"_process":24}],23:[function(require,module,exports){ +(function (process){ +'use strict'; + +function posix(path) { + return path.charAt(0) === '/'; +} + +function win32(path) { + // https://github.com/nodejs/node/blob/b3fcc245fb25539909ef1d5eaa01dbf92e168633/lib/path.js#L56 + var splitDeviceRe = /^([a-zA-Z]:|[\\\/]{2}[^\\\/]+[\\\/]+[^\\\/]+)?([\\\/])?([\s\S]*?)$/; + var result = splitDeviceRe.exec(path); + var device = result[1] || ''; + var isUnc = Boolean(device && device.charAt(1) !== ':'); + + // UNC paths are always absolute + return Boolean(result[2] || isUnc); +} + +module.exports = process.platform === 'win32' ? win32 : posix; +module.exports.posix = posix; +module.exports.win32 = win32; + +}).call(this,require('_process')) +},{"_process":24}],24:[function(require,module,exports){ +// shim for using process in browser +var process = module.exports = {}; + +// cached from whatever global is present so that test runners that stub it +// don't break things. But we need to wrap it in a try catch in case it is +// wrapped in strict mode code which doesn't define any globals. It's inside a +// function because try/catches deoptimize in certain engines. + +var cachedSetTimeout; +var cachedClearTimeout; + +function defaultSetTimout() { + throw new Error('setTimeout has not been defined'); +} +function defaultClearTimeout () { + throw new Error('clearTimeout has not been defined'); +} +(function () { + try { + if (typeof setTimeout === 'function') { + cachedSetTimeout = setTimeout; + } else { + cachedSetTimeout = defaultSetTimout; + } + } catch (e) { + cachedSetTimeout = defaultSetTimout; + } + try { + if (typeof clearTimeout === 'function') { + cachedClearTimeout = clearTimeout; + } else { + cachedClearTimeout = defaultClearTimeout; + } + } catch (e) { + cachedClearTimeout = defaultClearTimeout; + } +} ()) +function runTimeout(fun) { + if (cachedSetTimeout === setTimeout) { + //normal enviroments in sane situations + return setTimeout(fun, 0); + } + // if setTimeout wasn't available but was latter defined + if ((cachedSetTimeout === defaultSetTimout || !cachedSetTimeout) && setTimeout) { + cachedSetTimeout = setTimeout; + return setTimeout(fun, 0); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedSetTimeout(fun, 0); + } catch(e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedSetTimeout.call(null, fun, 0); + } catch(e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error + return cachedSetTimeout.call(this, fun, 0); + } + } + + +} +function runClearTimeout(marker) { + if (cachedClearTimeout === clearTimeout) { + //normal enviroments in sane situations + return clearTimeout(marker); + } + // if clearTimeout wasn't available but was latter defined + if ((cachedClearTimeout === defaultClearTimeout || !cachedClearTimeout) && clearTimeout) { + cachedClearTimeout = clearTimeout; + return clearTimeout(marker); + } + try { + // when when somebody has screwed with setTimeout but no I.E. maddness + return cachedClearTimeout(marker); + } catch (e){ + try { + // When we are in I.E. but the script has been evaled so I.E. doesn't trust the global object when called normally + return cachedClearTimeout.call(null, marker); + } catch (e){ + // same as above but when it's a version of I.E. that must have the global object for 'this', hopfully our context correct otherwise it will throw a global error. + // Some versions of I.E. have different rules for clearTimeout vs setTimeout + return cachedClearTimeout.call(this, marker); + } + } + + + +} +var queue = []; +var draining = false; +var currentQueue; +var queueIndex = -1; + +function cleanUpNextTick() { + if (!draining || !currentQueue) { + return; + } + draining = false; + if (currentQueue.length) { + queue = currentQueue.concat(queue); + } else { + queueIndex = -1; + } + if (queue.length) { + drainQueue(); + } +} + +function drainQueue() { + if (draining) { + return; + } + var timeout = runTimeout(cleanUpNextTick); + draining = true; + + var len = queue.length; + while(len) { + currentQueue = queue; + queue = []; + while (++queueIndex < len) { + if (currentQueue) { + currentQueue[queueIndex].run(); + } + } + queueIndex = -1; + len = queue.length; + } + currentQueue = null; + draining = false; + runClearTimeout(timeout); +} + +process.nextTick = function (fun) { + var args = new Array(arguments.length - 1); + if (arguments.length > 1) { + for (var i = 1; i < arguments.length; i++) { + args[i - 1] = arguments[i]; + } + } + queue.push(new Item(fun, args)); + if (queue.length === 1 && !draining) { + runTimeout(drainQueue); + } +}; + +// v8 likes predictible objects +function Item(fun, array) { + this.fun = fun; + this.array = array; +} +Item.prototype.run = function () { + this.fun.apply(null, this.array); +}; +process.title = 'browser'; +process.browser = true; +process.env = {}; +process.argv = []; +process.version = ''; // empty string to avoid regexp issues +process.versions = {}; + +function noop() {} + +process.on = noop; +process.addListener = noop; +process.once = noop; +process.off = noop; +process.removeListener = noop; +process.removeAllListeners = noop; +process.emit = noop; +process.prependListener = noop; +process.prependOnceListener = noop; + +process.listeners = function (name) { return [] } + +process.binding = function (name) { + throw new Error('process.binding is not supported'); +}; + +process.cwd = function () { return '/' }; +process.chdir = function (dir) { + throw new Error('process.chdir is not supported'); +}; +process.umask = function() { return 0; }; + +},{}],25:[function(require,module,exports){ +// Underscore.js 1.8.3 +// http://underscorejs.org +// (c) 2009-2015 Jeremy Ashkenas, DocumentCloud and Investigative Reporters & Editors +// Underscore may be freely distributed under the MIT license. + +(function() { + + // Baseline setup + // -------------- + + // Establish the root object, `window` in the browser, or `exports` on the server. + var root = this; + + // Save the previous value of the `_` variable. + var previousUnderscore = root._; + + // Save bytes in the minified (but not gzipped) version: + var ArrayProto = Array.prototype, ObjProto = Object.prototype, FuncProto = Function.prototype; + + // Create quick reference variables for speed access to core prototypes. + var + push = ArrayProto.push, + slice = ArrayProto.slice, + toString = ObjProto.toString, + hasOwnProperty = ObjProto.hasOwnProperty; + + // All **ECMAScript 5** native function implementations that we hope to use + // are declared here. + var + nativeIsArray = Array.isArray, + nativeKeys = Object.keys, + nativeBind = FuncProto.bind, + nativeCreate = Object.create; + + // Naked function reference for surrogate-prototype-swapping. + var Ctor = function(){}; + + // Create a safe reference to the Underscore object for use below. + var _ = function(obj) { + if (obj instanceof _) return obj; + if (!(this instanceof _)) return new _(obj); + this._wrapped = obj; + }; + + // Export the Underscore object for **Node.js**, with + // backwards-compatibility for the old `require()` API. If we're in + // the browser, add `_` as a global object. + if (typeof exports !== 'undefined') { + if (typeof module !== 'undefined' && module.exports) { + exports = module.exports = _; + } + exports._ = _; + } else { + root._ = _; + } + + // Current version. + _.VERSION = '1.8.3'; + + // Internal function that returns an efficient (for current engines) version + // of the passed-in callback, to be repeatedly applied in other Underscore + // functions. + var optimizeCb = function(func, context, argCount) { + if (context === void 0) return func; + switch (argCount == null ? 3 : argCount) { + case 1: return function(value) { + return func.call(context, value); + }; + case 2: return function(value, other) { + return func.call(context, value, other); + }; + case 3: return function(value, index, collection) { + return func.call(context, value, index, collection); + }; + case 4: return function(accumulator, value, index, collection) { + return func.call(context, accumulator, value, index, collection); + }; + } + return function() { + return func.apply(context, arguments); + }; + }; + + // A mostly-internal function to generate callbacks that can be applied + // to each element in a collection, returning the desired result — either + // identity, an arbitrary callback, a property matcher, or a property accessor. + var cb = function(value, context, argCount) { + if (value == null) return _.identity; + if (_.isFunction(value)) return optimizeCb(value, context, argCount); + if (_.isObject(value)) return _.matcher(value); + return _.property(value); + }; + _.iteratee = function(value, context) { + return cb(value, context, Infinity); + }; + + // An internal function for creating assigner functions. + var createAssigner = function(keysFunc, undefinedOnly) { + return function(obj) { + var length = arguments.length; + if (length < 2 || obj == null) return obj; + for (var index = 1; index < length; index++) { + var source = arguments[index], + keys = keysFunc(source), + l = keys.length; + for (var i = 0; i < l; i++) { + var key = keys[i]; + if (!undefinedOnly || obj[key] === void 0) obj[key] = source[key]; + } + } + return obj; + }; + }; + + // An internal function for creating a new object that inherits from another. + var baseCreate = function(prototype) { + if (!_.isObject(prototype)) return {}; + if (nativeCreate) return nativeCreate(prototype); + Ctor.prototype = prototype; + var result = new Ctor; + Ctor.prototype = null; + return result; + }; + + var property = function(key) { + return function(obj) { + return obj == null ? void 0 : obj[key]; + }; + }; + + // Helper for collection methods to determine whether a collection + // should be iterated as an array or as an object + // Related: http://people.mozilla.org/~jorendorff/es6-draft.html#sec-tolength + // Avoids a very nasty iOS 8 JIT bug on ARM-64. #2094 + var MAX_ARRAY_INDEX = Math.pow(2, 53) - 1; + var getLength = property('length'); + var isArrayLike = function(collection) { + var length = getLength(collection); + return typeof length == 'number' && length >= 0 && length <= MAX_ARRAY_INDEX; + }; + + // Collection Functions + // -------------------- + + // The cornerstone, an `each` implementation, aka `forEach`. + // Handles raw objects in addition to array-likes. Treats all + // sparse array-likes as if they were dense. + _.each = _.forEach = function(obj, iteratee, context) { + iteratee = optimizeCb(iteratee, context); + var i, length; + if (isArrayLike(obj)) { + for (i = 0, length = obj.length; i < length; i++) { + iteratee(obj[i], i, obj); + } + } else { + var keys = _.keys(obj); + for (i = 0, length = keys.length; i < length; i++) { + iteratee(obj[keys[i]], keys[i], obj); + } + } + return obj; + }; + + // Return the results of applying the iteratee to each element. + _.map = _.collect = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + results = Array(length); + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + results[index] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Create a reducing function iterating left or right. + function createReduce(dir) { + // Optimized iterator function as using arguments.length + // in the main function will deoptimize the, see #1991. + function iterator(obj, iteratee, memo, keys, index, length) { + for (; index >= 0 && index < length; index += dir) { + var currentKey = keys ? keys[index] : index; + memo = iteratee(memo, obj[currentKey], currentKey, obj); + } + return memo; + } + + return function(obj, iteratee, memo, context) { + iteratee = optimizeCb(iteratee, context, 4); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length, + index = dir > 0 ? 0 : length - 1; + // Determine the initial value if none is provided. + if (arguments.length < 3) { + memo = obj[keys ? keys[index] : index]; + index += dir; + } + return iterator(obj, iteratee, memo, keys, index, length); + }; + } + + // **Reduce** builds up a single result from a list of values, aka `inject`, + // or `foldl`. + _.reduce = _.foldl = _.inject = createReduce(1); + + // The right-associative version of reduce, also known as `foldr`. + _.reduceRight = _.foldr = createReduce(-1); + + // Return the first value which passes a truth test. Aliased as `detect`. + _.find = _.detect = function(obj, predicate, context) { + var key; + if (isArrayLike(obj)) { + key = _.findIndex(obj, predicate, context); + } else { + key = _.findKey(obj, predicate, context); + } + if (key !== void 0 && key !== -1) return obj[key]; + }; + + // Return all the elements that pass a truth test. + // Aliased as `select`. + _.filter = _.select = function(obj, predicate, context) { + var results = []; + predicate = cb(predicate, context); + _.each(obj, function(value, index, list) { + if (predicate(value, index, list)) results.push(value); + }); + return results; + }; + + // Return all the elements for which a truth test fails. + _.reject = function(obj, predicate, context) { + return _.filter(obj, _.negate(cb(predicate)), context); + }; + + // Determine whether all of the elements match a truth test. + // Aliased as `all`. + _.every = _.all = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (!predicate(obj[currentKey], currentKey, obj)) return false; + } + return true; + }; + + // Determine if at least one element in the object matches a truth test. + // Aliased as `any`. + _.some = _.any = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = !isArrayLike(obj) && _.keys(obj), + length = (keys || obj).length; + for (var index = 0; index < length; index++) { + var currentKey = keys ? keys[index] : index; + if (predicate(obj[currentKey], currentKey, obj)) return true; + } + return false; + }; + + // Determine if the array or object contains a given item (using `===`). + // Aliased as `includes` and `include`. + _.contains = _.includes = _.include = function(obj, item, fromIndex, guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + if (typeof fromIndex != 'number' || guard) fromIndex = 0; + return _.indexOf(obj, item, fromIndex) >= 0; + }; + + // Invoke a method (with arguments) on every item in a collection. + _.invoke = function(obj, method) { + var args = slice.call(arguments, 2); + var isFunc = _.isFunction(method); + return _.map(obj, function(value) { + var func = isFunc ? method : value[method]; + return func == null ? func : func.apply(value, args); + }); + }; + + // Convenience version of a common use case of `map`: fetching a property. + _.pluck = function(obj, key) { + return _.map(obj, _.property(key)); + }; + + // Convenience version of a common use case of `filter`: selecting only objects + // containing specific `key:value` pairs. + _.where = function(obj, attrs) { + return _.filter(obj, _.matcher(attrs)); + }; + + // Convenience version of a common use case of `find`: getting the first object + // containing specific `key:value` pairs. + _.findWhere = function(obj, attrs) { + return _.find(obj, _.matcher(attrs)); + }; + + // Return the maximum element (or element-based computation). + _.max = function(obj, iteratee, context) { + var result = -Infinity, lastComputed = -Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value > result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed > lastComputed || computed === -Infinity && result === -Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Return the minimum element (or element-based computation). + _.min = function(obj, iteratee, context) { + var result = Infinity, lastComputed = Infinity, + value, computed; + if (iteratee == null && obj != null) { + obj = isArrayLike(obj) ? obj : _.values(obj); + for (var i = 0, length = obj.length; i < length; i++) { + value = obj[i]; + if (value < result) { + result = value; + } + } + } else { + iteratee = cb(iteratee, context); + _.each(obj, function(value, index, list) { + computed = iteratee(value, index, list); + if (computed < lastComputed || computed === Infinity && result === Infinity) { + result = value; + lastComputed = computed; + } + }); + } + return result; + }; + + // Shuffle a collection, using the modern version of the + // [Fisher-Yates shuffle](http://en.wikipedia.org/wiki/Fisher–Yates_shuffle). + _.shuffle = function(obj) { + var set = isArrayLike(obj) ? obj : _.values(obj); + var length = set.length; + var shuffled = Array(length); + for (var index = 0, rand; index < length; index++) { + rand = _.random(0, index); + if (rand !== index) shuffled[index] = shuffled[rand]; + shuffled[rand] = set[index]; + } + return shuffled; + }; + + // Sample **n** random values from a collection. + // If **n** is not specified, returns a single random element. + // The internal `guard` argument allows it to work with `map`. + _.sample = function(obj, n, guard) { + if (n == null || guard) { + if (!isArrayLike(obj)) obj = _.values(obj); + return obj[_.random(obj.length - 1)]; + } + return _.shuffle(obj).slice(0, Math.max(0, n)); + }; + + // Sort the object's values by a criterion produced by an iteratee. + _.sortBy = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + return _.pluck(_.map(obj, function(value, index, list) { + return { + value: value, + index: index, + criteria: iteratee(value, index, list) + }; + }).sort(function(left, right) { + var a = left.criteria; + var b = right.criteria; + if (a !== b) { + if (a > b || a === void 0) return 1; + if (a < b || b === void 0) return -1; + } + return left.index - right.index; + }), 'value'); + }; + + // An internal function used for aggregate "group by" operations. + var group = function(behavior) { + return function(obj, iteratee, context) { + var result = {}; + iteratee = cb(iteratee, context); + _.each(obj, function(value, index) { + var key = iteratee(value, index, obj); + behavior(result, value, key); + }); + return result; + }; + }; + + // Groups the object's values by a criterion. Pass either a string attribute + // to group by, or a function that returns the criterion. + _.groupBy = group(function(result, value, key) { + if (_.has(result, key)) result[key].push(value); else result[key] = [value]; + }); + + // Indexes the object's values by a criterion, similar to `groupBy`, but for + // when you know that your index values will be unique. + _.indexBy = group(function(result, value, key) { + result[key] = value; + }); + + // Counts instances of an object that group by a certain criterion. Pass + // either a string attribute to count by, or a function that returns the + // criterion. + _.countBy = group(function(result, value, key) { + if (_.has(result, key)) result[key]++; else result[key] = 1; + }); + + // Safely create a real, live array from anything iterable. + _.toArray = function(obj) { + if (!obj) return []; + if (_.isArray(obj)) return slice.call(obj); + if (isArrayLike(obj)) return _.map(obj, _.identity); + return _.values(obj); + }; + + // Return the number of elements in an object. + _.size = function(obj) { + if (obj == null) return 0; + return isArrayLike(obj) ? obj.length : _.keys(obj).length; + }; + + // Split a collection into two arrays: one whose elements all satisfy the given + // predicate, and one whose elements all do not satisfy the predicate. + _.partition = function(obj, predicate, context) { + predicate = cb(predicate, context); + var pass = [], fail = []; + _.each(obj, function(value, key, obj) { + (predicate(value, key, obj) ? pass : fail).push(value); + }); + return [pass, fail]; + }; + + // Array Functions + // --------------- + + // Get the first element of an array. Passing **n** will return the first N + // values in the array. Aliased as `head` and `take`. The **guard** check + // allows it to work with `_.map`. + _.first = _.head = _.take = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[0]; + return _.initial(array, array.length - n); + }; + + // Returns everything but the last entry of the array. Especially useful on + // the arguments object. Passing **n** will return all the values in + // the array, excluding the last N. + _.initial = function(array, n, guard) { + return slice.call(array, 0, Math.max(0, array.length - (n == null || guard ? 1 : n))); + }; + + // Get the last element of an array. Passing **n** will return the last N + // values in the array. + _.last = function(array, n, guard) { + if (array == null) return void 0; + if (n == null || guard) return array[array.length - 1]; + return _.rest(array, Math.max(0, array.length - n)); + }; + + // Returns everything but the first entry of the array. Aliased as `tail` and `drop`. + // Especially useful on the arguments object. Passing an **n** will return + // the rest N values in the array. + _.rest = _.tail = _.drop = function(array, n, guard) { + return slice.call(array, n == null || guard ? 1 : n); + }; + + // Trim out all falsy values from an array. + _.compact = function(array) { + return _.filter(array, _.identity); + }; + + // Internal implementation of a recursive `flatten` function. + var flatten = function(input, shallow, strict, startIndex) { + var output = [], idx = 0; + for (var i = startIndex || 0, length = getLength(input); i < length; i++) { + var value = input[i]; + if (isArrayLike(value) && (_.isArray(value) || _.isArguments(value))) { + //flatten current level of array or arguments object + if (!shallow) value = flatten(value, shallow, strict); + var j = 0, len = value.length; + output.length += len; + while (j < len) { + output[idx++] = value[j++]; + } + } else if (!strict) { + output[idx++] = value; + } + } + return output; + }; + + // Flatten out an array, either recursively (by default), or just one level. + _.flatten = function(array, shallow) { + return flatten(array, shallow, false); + }; + + // Return a version of the array that does not contain the specified value(s). + _.without = function(array) { + return _.difference(array, slice.call(arguments, 1)); + }; + + // Produce a duplicate-free version of the array. If the array has already + // been sorted, you have the option of using a faster algorithm. + // Aliased as `unique`. + _.uniq = _.unique = function(array, isSorted, iteratee, context) { + if (!_.isBoolean(isSorted)) { + context = iteratee; + iteratee = isSorted; + isSorted = false; + } + if (iteratee != null) iteratee = cb(iteratee, context); + var result = []; + var seen = []; + for (var i = 0, length = getLength(array); i < length; i++) { + var value = array[i], + computed = iteratee ? iteratee(value, i, array) : value; + if (isSorted) { + if (!i || seen !== computed) result.push(value); + seen = computed; + } else if (iteratee) { + if (!_.contains(seen, computed)) { + seen.push(computed); + result.push(value); + } + } else if (!_.contains(result, value)) { + result.push(value); + } + } + return result; + }; + + // Produce an array that contains the union: each distinct element from all of + // the passed-in arrays. + _.union = function() { + return _.uniq(flatten(arguments, true, true)); + }; + + // Produce an array that contains every item shared between all the + // passed-in arrays. + _.intersection = function(array) { + var result = []; + var argsLength = arguments.length; + for (var i = 0, length = getLength(array); i < length; i++) { + var item = array[i]; + if (_.contains(result, item)) continue; + for (var j = 1; j < argsLength; j++) { + if (!_.contains(arguments[j], item)) break; + } + if (j === argsLength) result.push(item); + } + return result; + }; + + // Take the difference between one array and a number of other arrays. + // Only the elements present in just the first array will remain. + _.difference = function(array) { + var rest = flatten(arguments, true, true, 1); + return _.filter(array, function(value){ + return !_.contains(rest, value); + }); + }; + + // Zip together multiple lists into a single array -- elements that share + // an index go together. + _.zip = function() { + return _.unzip(arguments); + }; + + // Complement of _.zip. Unzip accepts an array of arrays and groups + // each array's elements on shared indices + _.unzip = function(array) { + var length = array && _.max(array, getLength).length || 0; + var result = Array(length); + + for (var index = 0; index < length; index++) { + result[index] = _.pluck(array, index); + } + return result; + }; + + // Converts lists into objects. Pass either a single array of `[key, value]` + // pairs, or two parallel arrays of the same length -- one of keys, and one of + // the corresponding values. + _.object = function(list, values) { + var result = {}; + for (var i = 0, length = getLength(list); i < length; i++) { + if (values) { + result[list[i]] = values[i]; + } else { + result[list[i][0]] = list[i][1]; + } + } + return result; + }; + + // Generator function to create the findIndex and findLastIndex functions + function createPredicateIndexFinder(dir) { + return function(array, predicate, context) { + predicate = cb(predicate, context); + var length = getLength(array); + var index = dir > 0 ? 0 : length - 1; + for (; index >= 0 && index < length; index += dir) { + if (predicate(array[index], index, array)) return index; + } + return -1; + }; + } + + // Returns the first index on an array-like that passes a predicate test + _.findIndex = createPredicateIndexFinder(1); + _.findLastIndex = createPredicateIndexFinder(-1); + + // Use a comparator function to figure out the smallest index at which + // an object should be inserted so as to maintain order. Uses binary search. + _.sortedIndex = function(array, obj, iteratee, context) { + iteratee = cb(iteratee, context, 1); + var value = iteratee(obj); + var low = 0, high = getLength(array); + while (low < high) { + var mid = Math.floor((low + high) / 2); + if (iteratee(array[mid]) < value) low = mid + 1; else high = mid; + } + return low; + }; + + // Generator function to create the indexOf and lastIndexOf functions + function createIndexFinder(dir, predicateFind, sortedIndex) { + return function(array, item, idx) { + var i = 0, length = getLength(array); + if (typeof idx == 'number') { + if (dir > 0) { + i = idx >= 0 ? idx : Math.max(idx + length, i); + } else { + length = idx >= 0 ? Math.min(idx + 1, length) : idx + length + 1; + } + } else if (sortedIndex && idx && length) { + idx = sortedIndex(array, item); + return array[idx] === item ? idx : -1; + } + if (item !== item) { + idx = predicateFind(slice.call(array, i, length), _.isNaN); + return idx >= 0 ? idx + i : -1; + } + for (idx = dir > 0 ? i : length - 1; idx >= 0 && idx < length; idx += dir) { + if (array[idx] === item) return idx; + } + return -1; + }; + } + + // Return the position of the first occurrence of an item in an array, + // or -1 if the item is not included in the array. + // If the array is large and already in sort order, pass `true` + // for **isSorted** to use binary search. + _.indexOf = createIndexFinder(1, _.findIndex, _.sortedIndex); + _.lastIndexOf = createIndexFinder(-1, _.findLastIndex); + + // Generate an integer Array containing an arithmetic progression. A port of + // the native Python `range()` function. See + // [the Python documentation](http://docs.python.org/library/functions.html#range). + _.range = function(start, stop, step) { + if (stop == null) { + stop = start || 0; + start = 0; + } + step = step || 1; + + var length = Math.max(Math.ceil((stop - start) / step), 0); + var range = Array(length); + + for (var idx = 0; idx < length; idx++, start += step) { + range[idx] = start; + } + + return range; + }; + + // Function (ahem) Functions + // ------------------ + + // Determines whether to execute a function as a constructor + // or a normal function with the provided arguments + var executeBound = function(sourceFunc, boundFunc, context, callingContext, args) { + if (!(callingContext instanceof boundFunc)) return sourceFunc.apply(context, args); + var self = baseCreate(sourceFunc.prototype); + var result = sourceFunc.apply(self, args); + if (_.isObject(result)) return result; + return self; + }; + + // Create a function bound to a given object (assigning `this`, and arguments, + // optionally). Delegates to **ECMAScript 5**'s native `Function.bind` if + // available. + _.bind = function(func, context) { + if (nativeBind && func.bind === nativeBind) return nativeBind.apply(func, slice.call(arguments, 1)); + if (!_.isFunction(func)) throw new TypeError('Bind must be called on a function'); + var args = slice.call(arguments, 2); + var bound = function() { + return executeBound(func, bound, context, this, args.concat(slice.call(arguments))); + }; + return bound; + }; + + // Partially apply a function by creating a version that has had some of its + // arguments pre-filled, without changing its dynamic `this` context. _ acts + // as a placeholder, allowing any combination of arguments to be pre-filled. + _.partial = function(func) { + var boundArgs = slice.call(arguments, 1); + var bound = function() { + var position = 0, length = boundArgs.length; + var args = Array(length); + for (var i = 0; i < length; i++) { + args[i] = boundArgs[i] === _ ? arguments[position++] : boundArgs[i]; + } + while (position < arguments.length) args.push(arguments[position++]); + return executeBound(func, bound, this, this, args); + }; + return bound; + }; + + // Bind a number of an object's methods to that object. Remaining arguments + // are the method names to be bound. Useful for ensuring that all callbacks + // defined on an object belong to it. + _.bindAll = function(obj) { + var i, length = arguments.length, key; + if (length <= 1) throw new Error('bindAll must be passed function names'); + for (i = 1; i < length; i++) { + key = arguments[i]; + obj[key] = _.bind(obj[key], obj); + } + return obj; + }; + + // Memoize an expensive function by storing its results. + _.memoize = function(func, hasher) { + var memoize = function(key) { + var cache = memoize.cache; + var address = '' + (hasher ? hasher.apply(this, arguments) : key); + if (!_.has(cache, address)) cache[address] = func.apply(this, arguments); + return cache[address]; + }; + memoize.cache = {}; + return memoize; + }; + + // Delays a function for the given number of milliseconds, and then calls + // it with the arguments supplied. + _.delay = function(func, wait) { + var args = slice.call(arguments, 2); + return setTimeout(function(){ + return func.apply(null, args); + }, wait); + }; + + // Defers a function, scheduling it to run after the current call stack has + // cleared. + _.defer = _.partial(_.delay, _, 1); + + // Returns a function, that, when invoked, will only be triggered at most once + // during a given window of time. Normally, the throttled function will run + // as much as it can, without ever going more than once per `wait` duration; + // but if you'd like to disable the execution on the leading edge, pass + // `{leading: false}`. To disable execution on the trailing edge, ditto. + _.throttle = function(func, wait, options) { + var context, args, result; + var timeout = null; + var previous = 0; + if (!options) options = {}; + var later = function() { + previous = options.leading === false ? 0 : _.now(); + timeout = null; + result = func.apply(context, args); + if (!timeout) context = args = null; + }; + return function() { + var now = _.now(); + if (!previous && options.leading === false) previous = now; + var remaining = wait - (now - previous); + context = this; + args = arguments; + if (remaining <= 0 || remaining > wait) { + if (timeout) { + clearTimeout(timeout); + timeout = null; + } + previous = now; + result = func.apply(context, args); + if (!timeout) context = args = null; + } else if (!timeout && options.trailing !== false) { + timeout = setTimeout(later, remaining); + } + return result; + }; + }; + + // Returns a function, that, as long as it continues to be invoked, will not + // be triggered. The function will be called after it stops being called for + // N milliseconds. If `immediate` is passed, trigger the function on the + // leading edge, instead of the trailing. + _.debounce = function(func, wait, immediate) { + var timeout, args, context, timestamp, result; + + var later = function() { + var last = _.now() - timestamp; + + if (last < wait && last >= 0) { + timeout = setTimeout(later, wait - last); + } else { + timeout = null; + if (!immediate) { + result = func.apply(context, args); + if (!timeout) context = args = null; + } + } + }; + + return function() { + context = this; + args = arguments; + timestamp = _.now(); + var callNow = immediate && !timeout; + if (!timeout) timeout = setTimeout(later, wait); + if (callNow) { + result = func.apply(context, args); + context = args = null; + } + + return result; + }; + }; + + // Returns the first function passed as an argument to the second, + // allowing you to adjust arguments, run code before and after, and + // conditionally execute the original function. + _.wrap = function(func, wrapper) { + return _.partial(wrapper, func); + }; + + // Returns a negated version of the passed-in predicate. + _.negate = function(predicate) { + return function() { + return !predicate.apply(this, arguments); + }; + }; + + // Returns a function that is the composition of a list of functions, each + // consuming the return value of the function that follows. + _.compose = function() { + var args = arguments; + var start = args.length - 1; + return function() { + var i = start; + var result = args[start].apply(this, arguments); + while (i--) result = args[i].call(this, result); + return result; + }; + }; + + // Returns a function that will only be executed on and after the Nth call. + _.after = function(times, func) { + return function() { + if (--times < 1) { + return func.apply(this, arguments); + } + }; + }; + + // Returns a function that will only be executed up to (but not including) the Nth call. + _.before = function(times, func) { + var memo; + return function() { + if (--times > 0) { + memo = func.apply(this, arguments); + } + if (times <= 1) func = null; + return memo; + }; + }; + + // Returns a function that will be executed at most one time, no matter how + // often you call it. Useful for lazy initialization. + _.once = _.partial(_.before, 2); + + // Object Functions + // ---------------- + + // Keys in IE < 9 that won't be iterated by `for key in ...` and thus missed. + var hasEnumBug = !{toString: null}.propertyIsEnumerable('toString'); + var nonEnumerableProps = ['valueOf', 'isPrototypeOf', 'toString', + 'propertyIsEnumerable', 'hasOwnProperty', 'toLocaleString']; + + function collectNonEnumProps(obj, keys) { + var nonEnumIdx = nonEnumerableProps.length; + var constructor = obj.constructor; + var proto = (_.isFunction(constructor) && constructor.prototype) || ObjProto; + + // Constructor is a special case. + var prop = 'constructor'; + if (_.has(obj, prop) && !_.contains(keys, prop)) keys.push(prop); + + while (nonEnumIdx--) { + prop = nonEnumerableProps[nonEnumIdx]; + if (prop in obj && obj[prop] !== proto[prop] && !_.contains(keys, prop)) { + keys.push(prop); + } + } + } + + // Retrieve the names of an object's own properties. + // Delegates to **ECMAScript 5**'s native `Object.keys` + _.keys = function(obj) { + if (!_.isObject(obj)) return []; + if (nativeKeys) return nativeKeys(obj); + var keys = []; + for (var key in obj) if (_.has(obj, key)) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve all the property names of an object. + _.allKeys = function(obj) { + if (!_.isObject(obj)) return []; + var keys = []; + for (var key in obj) keys.push(key); + // Ahem, IE < 9. + if (hasEnumBug) collectNonEnumProps(obj, keys); + return keys; + }; + + // Retrieve the values of an object's properties. + _.values = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var values = Array(length); + for (var i = 0; i < length; i++) { + values[i] = obj[keys[i]]; + } + return values; + }; + + // Returns the results of applying the iteratee to each element of the object + // In contrast to _.map it returns an object + _.mapObject = function(obj, iteratee, context) { + iteratee = cb(iteratee, context); + var keys = _.keys(obj), + length = keys.length, + results = {}, + currentKey; + for (var index = 0; index < length; index++) { + currentKey = keys[index]; + results[currentKey] = iteratee(obj[currentKey], currentKey, obj); + } + return results; + }; + + // Convert an object into a list of `[key, value]` pairs. + _.pairs = function(obj) { + var keys = _.keys(obj); + var length = keys.length; + var pairs = Array(length); + for (var i = 0; i < length; i++) { + pairs[i] = [keys[i], obj[keys[i]]]; + } + return pairs; + }; + + // Invert the keys and values of an object. The values must be serializable. + _.invert = function(obj) { + var result = {}; + var keys = _.keys(obj); + for (var i = 0, length = keys.length; i < length; i++) { + result[obj[keys[i]]] = keys[i]; + } + return result; + }; + + // Return a sorted list of the function names available on the object. + // Aliased as `methods` + _.functions = _.methods = function(obj) { + var names = []; + for (var key in obj) { + if (_.isFunction(obj[key])) names.push(key); + } + return names.sort(); + }; + + // Extend a given object with all the properties in passed-in object(s). + _.extend = createAssigner(_.allKeys); + + // Assigns a given object with all the own properties in the passed-in object(s) + // (https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object/assign) + _.extendOwn = _.assign = createAssigner(_.keys); + + // Returns the first key on an object that passes a predicate test + _.findKey = function(obj, predicate, context) { + predicate = cb(predicate, context); + var keys = _.keys(obj), key; + for (var i = 0, length = keys.length; i < length; i++) { + key = keys[i]; + if (predicate(obj[key], key, obj)) return key; + } + }; + + // Return a copy of the object only containing the whitelisted properties. + _.pick = function(object, oiteratee, context) { + var result = {}, obj = object, iteratee, keys; + if (obj == null) return result; + if (_.isFunction(oiteratee)) { + keys = _.allKeys(obj); + iteratee = optimizeCb(oiteratee, context); + } else { + keys = flatten(arguments, false, false, 1); + iteratee = function(value, key, obj) { return key in obj; }; + obj = Object(obj); + } + for (var i = 0, length = keys.length; i < length; i++) { + var key = keys[i]; + var value = obj[key]; + if (iteratee(value, key, obj)) result[key] = value; + } + return result; + }; + + // Return a copy of the object without the blacklisted properties. + _.omit = function(obj, iteratee, context) { + if (_.isFunction(iteratee)) { + iteratee = _.negate(iteratee); + } else { + var keys = _.map(flatten(arguments, false, false, 1), String); + iteratee = function(value, key) { + return !_.contains(keys, key); + }; + } + return _.pick(obj, iteratee, context); + }; + + // Fill in a given object with default properties. + _.defaults = createAssigner(_.allKeys, true); + + // Creates an object that inherits from the given prototype object. + // If additional properties are provided then they will be added to the + // created object. + _.create = function(prototype, props) { + var result = baseCreate(prototype); + if (props) _.extendOwn(result, props); + return result; + }; + + // Create a (shallow-cloned) duplicate of an object. + _.clone = function(obj) { + if (!_.isObject(obj)) return obj; + return _.isArray(obj) ? obj.slice() : _.extend({}, obj); + }; + + // Invokes interceptor with the obj, and then returns obj. + // The primary purpose of this method is to "tap into" a method chain, in + // order to perform operations on intermediate results within the chain. + _.tap = function(obj, interceptor) { + interceptor(obj); + return obj; + }; + + // Returns whether an object has a given set of `key:value` pairs. + _.isMatch = function(object, attrs) { + var keys = _.keys(attrs), length = keys.length; + if (object == null) return !length; + var obj = Object(object); + for (var i = 0; i < length; i++) { + var key = keys[i]; + if (attrs[key] !== obj[key] || !(key in obj)) return false; + } + return true; + }; + + + // Internal recursive comparison function for `isEqual`. + var eq = function(a, b, aStack, bStack) { + // Identical objects are equal. `0 === -0`, but they aren't identical. + // See the [Harmony `egal` proposal](http://wiki.ecmascript.org/doku.php?id=harmony:egal). + if (a === b) return a !== 0 || 1 / a === 1 / b; + // A strict comparison is necessary because `null == undefined`. + if (a == null || b == null) return a === b; + // Unwrap any wrapped objects. + if (a instanceof _) a = a._wrapped; + if (b instanceof _) b = b._wrapped; + // Compare `[[Class]]` names. + var className = toString.call(a); + if (className !== toString.call(b)) return false; + switch (className) { + // Strings, numbers, regular expressions, dates, and booleans are compared by value. + case '[object RegExp]': + // RegExps are coerced to strings for comparison (Note: '' + /a/i === '/a/i') + case '[object String]': + // Primitives and their corresponding object wrappers are equivalent; thus, `"5"` is + // equivalent to `new String("5")`. + return '' + a === '' + b; + case '[object Number]': + // `NaN`s are equivalent, but non-reflexive. + // Object(NaN) is equivalent to NaN + if (+a !== +a) return +b !== +b; + // An `egal` comparison is performed for other numeric values. + return +a === 0 ? 1 / +a === 1 / b : +a === +b; + case '[object Date]': + case '[object Boolean]': + // Coerce dates and booleans to numeric primitive values. Dates are compared by their + // millisecond representations. Note that invalid dates with millisecond representations + // of `NaN` are not equivalent. + return +a === +b; + } + + var areArrays = className === '[object Array]'; + if (!areArrays) { + if (typeof a != 'object' || typeof b != 'object') return false; + + // Objects with different constructors are not equivalent, but `Object`s or `Array`s + // from different frames are. + var aCtor = a.constructor, bCtor = b.constructor; + if (aCtor !== bCtor && !(_.isFunction(aCtor) && aCtor instanceof aCtor && + _.isFunction(bCtor) && bCtor instanceof bCtor) + && ('constructor' in a && 'constructor' in b)) { + return false; + } + } + // Assume equality for cyclic structures. The algorithm for detecting cyclic + // structures is adapted from ES 5.1 section 15.12.3, abstract operation `JO`. + + // Initializing stack of traversed objects. + // It's done here since we only need them for objects and arrays comparison. + aStack = aStack || []; + bStack = bStack || []; + var length = aStack.length; + while (length--) { + // Linear search. Performance is inversely proportional to the number of + // unique nested structures. + if (aStack[length] === a) return bStack[length] === b; + } + + // Add the first object to the stack of traversed objects. + aStack.push(a); + bStack.push(b); + + // Recursively compare objects and arrays. + if (areArrays) { + // Compare array lengths to determine if a deep comparison is necessary. + length = a.length; + if (length !== b.length) return false; + // Deep compare the contents, ignoring non-numeric properties. + while (length--) { + if (!eq(a[length], b[length], aStack, bStack)) return false; + } + } else { + // Deep compare objects. + var keys = _.keys(a), key; + length = keys.length; + // Ensure that both objects contain the same number of properties before comparing deep equality. + if (_.keys(b).length !== length) return false; + while (length--) { + // Deep compare each member + key = keys[length]; + if (!(_.has(b, key) && eq(a[key], b[key], aStack, bStack))) return false; + } + } + // Remove the first object from the stack of traversed objects. + aStack.pop(); + bStack.pop(); + return true; + }; + + // Perform a deep comparison to check if two objects are equal. + _.isEqual = function(a, b) { + return eq(a, b); + }; + + // Is a given array, string, or object empty? + // An "empty" object has no enumerable own-properties. + _.isEmpty = function(obj) { + if (obj == null) return true; + if (isArrayLike(obj) && (_.isArray(obj) || _.isString(obj) || _.isArguments(obj))) return obj.length === 0; + return _.keys(obj).length === 0; + }; + + // Is a given value a DOM element? + _.isElement = function(obj) { + return !!(obj && obj.nodeType === 1); + }; + + // Is a given value an array? + // Delegates to ECMA5's native Array.isArray + _.isArray = nativeIsArray || function(obj) { + return toString.call(obj) === '[object Array]'; + }; + + // Is a given variable an object? + _.isObject = function(obj) { + var type = typeof obj; + return type === 'function' || type === 'object' && !!obj; + }; + + // Add some isType methods: isArguments, isFunction, isString, isNumber, isDate, isRegExp, isError. + _.each(['Arguments', 'Function', 'String', 'Number', 'Date', 'RegExp', 'Error'], function(name) { + _['is' + name] = function(obj) { + return toString.call(obj) === '[object ' + name + ']'; + }; + }); + + // Define a fallback version of the method in browsers (ahem, IE < 9), where + // there isn't any inspectable "Arguments" type. + if (!_.isArguments(arguments)) { + _.isArguments = function(obj) { + return _.has(obj, 'callee'); + }; + } + + // Optimize `isFunction` if appropriate. Work around some typeof bugs in old v8, + // IE 11 (#1621), and in Safari 8 (#1929). + if (typeof /./ != 'function' && typeof Int8Array != 'object') { + _.isFunction = function(obj) { + return typeof obj == 'function' || false; + }; + } + + // Is a given object a finite number? + _.isFinite = function(obj) { + return isFinite(obj) && !isNaN(parseFloat(obj)); + }; + + // Is the given value `NaN`? (NaN is the only number which does not equal itself). + _.isNaN = function(obj) { + return _.isNumber(obj) && obj !== +obj; + }; + + // Is a given value a boolean? + _.isBoolean = function(obj) { + return obj === true || obj === false || toString.call(obj) === '[object Boolean]'; + }; + + // Is a given value equal to null? + _.isNull = function(obj) { + return obj === null; + }; + + // Is a given variable undefined? + _.isUndefined = function(obj) { + return obj === void 0; + }; + + // Shortcut function for checking if an object has a given property directly + // on itself (in other words, not on a prototype). + _.has = function(obj, key) { + return obj != null && hasOwnProperty.call(obj, key); + }; + + // Utility Functions + // ----------------- + + // Run Underscore.js in *noConflict* mode, returning the `_` variable to its + // previous owner. Returns a reference to the Underscore object. + _.noConflict = function() { + root._ = previousUnderscore; + return this; + }; + + // Keep the identity function around for default iteratees. + _.identity = function(value) { + return value; + }; + + // Predicate-generating functions. Often useful outside of Underscore. + _.constant = function(value) { + return function() { + return value; + }; + }; + + _.noop = function(){}; + + _.property = property; + + // Generates a function for a given object that returns a given property. + _.propertyOf = function(obj) { + return obj == null ? function(){} : function(key) { + return obj[key]; + }; + }; + + // Returns a predicate for checking whether an object has a given set of + // `key:value` pairs. + _.matcher = _.matches = function(attrs) { + attrs = _.extendOwn({}, attrs); + return function(obj) { + return _.isMatch(obj, attrs); + }; + }; + + // Run a function **n** times. + _.times = function(n, iteratee, context) { + var accum = Array(Math.max(0, n)); + iteratee = optimizeCb(iteratee, context, 1); + for (var i = 0; i < n; i++) accum[i] = iteratee(i); + return accum; + }; + + // Return a random integer between min and max (inclusive). + _.random = function(min, max) { + if (max == null) { + max = min; + min = 0; + } + return min + Math.floor(Math.random() * (max - min + 1)); + }; + + // A (possibly faster) way to get the current timestamp as an integer. + _.now = Date.now || function() { + return new Date().getTime(); + }; + + // List of HTML entities for escaping. + var escapeMap = { + '&': '&', + '<': '<', + '>': '>', + '"': '"', + "'": ''', + '`': '`' + }; + var unescapeMap = _.invert(escapeMap); + + // Functions for escaping and unescaping strings to/from HTML interpolation. + var createEscaper = function(map) { + var escaper = function(match) { + return map[match]; + }; + // Regexes for identifying a key that needs to be escaped + var source = '(?:' + _.keys(map).join('|') + ')'; + var testRegexp = RegExp(source); + var replaceRegexp = RegExp(source, 'g'); + return function(string) { + string = string == null ? '' : '' + string; + return testRegexp.test(string) ? string.replace(replaceRegexp, escaper) : string; + }; + }; + _.escape = createEscaper(escapeMap); + _.unescape = createEscaper(unescapeMap); + + // If the value of the named `property` is a function then invoke it with the + // `object` as context; otherwise, return it. + _.result = function(object, property, fallback) { + var value = object == null ? void 0 : object[property]; + if (value === void 0) { + value = fallback; + } + return _.isFunction(value) ? value.call(object) : value; + }; + + // Generate a unique integer id (unique within the entire client session). + // Useful for temporary DOM ids. + var idCounter = 0; + _.uniqueId = function(prefix) { + var id = ++idCounter + ''; + return prefix ? prefix + id : id; + }; + + // By default, Underscore uses ERB-style template delimiters, change the + // following template settings to use alternative delimiters. + _.templateSettings = { + evaluate : /<%([\s\S]+?)%>/g, + interpolate : /<%=([\s\S]+?)%>/g, + escape : /<%-([\s\S]+?)%>/g + }; + + // When customizing `templateSettings`, if you don't want to define an + // interpolation, evaluation or escaping regex, we need one that is + // guaranteed not to match. + var noMatch = /(.)^/; + + // Certain characters need to be escaped so that they can be put into a + // string literal. + var escapes = { + "'": "'", + '\\': '\\', + '\r': 'r', + '\n': 'n', + '\u2028': 'u2028', + '\u2029': 'u2029' + }; + + var escaper = /\\|'|\r|\n|\u2028|\u2029/g; + + var escapeChar = function(match) { + return '\\' + escapes[match]; + }; + + // JavaScript micro-templating, similar to John Resig's implementation. + // Underscore templating handles arbitrary delimiters, preserves whitespace, + // and correctly escapes quotes within interpolated code. + // NB: `oldSettings` only exists for backwards compatibility. + _.template = function(text, settings, oldSettings) { + if (!settings && oldSettings) settings = oldSettings; + settings = _.defaults({}, settings, _.templateSettings); + + // Combine delimiters into one regular expression via alternation. + var matcher = RegExp([ + (settings.escape || noMatch).source, + (settings.interpolate || noMatch).source, + (settings.evaluate || noMatch).source + ].join('|') + '|$', 'g'); + + // Compile the template source, escaping string literals appropriately. + var index = 0; + var source = "__p+='"; + text.replace(matcher, function(match, escape, interpolate, evaluate, offset) { + source += text.slice(index, offset).replace(escaper, escapeChar); + index = offset + match.length; + + if (escape) { + source += "'+\n((__t=(" + escape + "))==null?'':_.escape(__t))+\n'"; + } else if (interpolate) { + source += "'+\n((__t=(" + interpolate + "))==null?'':__t)+\n'"; + } else if (evaluate) { + source += "';\n" + evaluate + "\n__p+='"; + } + + // Adobe VMs need the match returned to produce the correct offest. + return match; + }); + source += "';\n"; + + // If a variable is not specified, place data values in local scope. + if (!settings.variable) source = 'with(obj||{}){\n' + source + '}\n'; + + source = "var __t,__p='',__j=Array.prototype.join," + + "print=function(){__p+=__j.call(arguments,'');};\n" + + source + 'return __p;\n'; + + try { + var render = new Function(settings.variable || 'obj', '_', source); + } catch (e) { + e.source = source; + throw e; + } + + var template = function(data) { + return render.call(this, data, _); + }; + + // Provide the compiled source as a convenience for precompilation. + var argument = settings.variable || 'obj'; + template.source = 'function(' + argument + '){\n' + source + '}'; + + return template; + }; + + // Add a "chain" function. Start chaining a wrapped Underscore object. + _.chain = function(obj) { + var instance = _(obj); + instance._chain = true; + return instance; + }; + + // OOP + // --------------- + // If Underscore is called as a function, it returns a wrapped object that + // can be used OO-style. This wrapper holds altered versions of all the + // underscore functions. Wrapped objects may be chained. + + // Helper function to continue chaining intermediate results. + var result = function(instance, obj) { + return instance._chain ? _(obj).chain() : obj; + }; + + // Add your own custom functions to the Underscore object. + _.mixin = function(obj) { + _.each(_.functions(obj), function(name) { + var func = _[name] = obj[name]; + _.prototype[name] = function() { + var args = [this._wrapped]; + push.apply(args, arguments); + return result(this, func.apply(_, args)); + }; + }); + }; + + // Add all of the Underscore functions to the wrapper object. + _.mixin(_); + + // Add all mutator Array functions to the wrapper. + _.each(['pop', 'push', 'reverse', 'shift', 'sort', 'splice', 'unshift'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + var obj = this._wrapped; + method.apply(obj, arguments); + if ((name === 'shift' || name === 'splice') && obj.length === 0) delete obj[0]; + return result(this, obj); + }; + }); + + // Add all accessor Array functions to the wrapper. + _.each(['concat', 'join', 'slice'], function(name) { + var method = ArrayProto[name]; + _.prototype[name] = function() { + return result(this, method.apply(this._wrapped, arguments)); + }; + }); + + // Extracts the result from a wrapped and chained object. + _.prototype.value = function() { + return this._wrapped; + }; + + // Provide unwrapping proxy for some methods used in engine operations + // such as arithmetic and JSON stringification. + _.prototype.valueOf = _.prototype.toJSON = _.prototype.value; + + _.prototype.toString = function() { + return '' + this._wrapped; + }; + + // AMD registration happens at the end for compatibility with AMD loaders + // that may not enforce next-turn semantics on modules. Even though general + // practice for AMD registration is to be anonymous, underscore registers + // as a named module because, like jQuery, it is a base library that is + // popular enough to be bundled in a third party lib, but not be part of + // an AMD load request. Those cases could generate an error when an + // anonymous define() is called outside of a loader request. + if (typeof define === 'function' && define.amd) { + define('underscore', [], function() { + return _; + }); + } +}.call(this)); + +},{}],26:[function(require,module,exports){ +arguments[4][19][0].apply(exports,arguments) +},{"dup":19}],27:[function(require,module,exports){ +module.exports = function isBuffer(arg) { + return arg && typeof arg === 'object' + && typeof arg.copy === 'function' + && typeof arg.fill === 'function' + && typeof arg.readUInt8 === 'function'; +} +},{}],28:[function(require,module,exports){ +(function (process,global){ +// Copyright Joyent, Inc. and other Node contributors. +// +// Permission is hereby granted, free of charge, to any person obtaining a +// copy of this software and associated documentation files (the +// "Software"), to deal in the Software without restriction, including +// without limitation the rights to use, copy, modify, merge, publish, +// distribute, sublicense, and/or sell copies of the Software, and to permit +// persons to whom the Software is furnished to do so, subject to the +// following conditions: +// +// The above copyright notice and this permission notice shall be included +// in all copies or substantial portions of the Software. +// +// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS +// OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF +// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN +// NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, +// DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR +// OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE +// USE OR OTHER DEALINGS IN THE SOFTWARE. + +var formatRegExp = /%[sdj%]/g; +exports.format = function(f) { + if (!isString(f)) { + var objects = []; + for (var i = 0; i < arguments.length; i++) { + objects.push(inspect(arguments[i])); + } + return objects.join(' '); + } + + var i = 1; + var args = arguments; + var len = args.length; + var str = String(f).replace(formatRegExp, function(x) { + if (x === '%%') return '%'; + if (i >= len) return x; + switch (x) { + case '%s': return String(args[i++]); + case '%d': return Number(args[i++]); + case '%j': + try { + return JSON.stringify(args[i++]); + } catch (_) { + return '[Circular]'; + } + default: + return x; + } + }); + for (var x = args[i]; i < len; x = args[++i]) { + if (isNull(x) || !isObject(x)) { + str += ' ' + x; + } else { + str += ' ' + inspect(x); + } + } + return str; +}; + + +// Mark that a method should not be used. +// Returns a modified function which warns once by default. +// If --no-deprecation is set, then it is a no-op. +exports.deprecate = function(fn, msg) { + // Allow for deprecating things in the process of starting up. + if (isUndefined(global.process)) { + return function() { + return exports.deprecate(fn, msg).apply(this, arguments); + }; + } + + if (process.noDeprecation === true) { + return fn; + } + + var warned = false; + function deprecated() { + if (!warned) { + if (process.throwDeprecation) { + throw new Error(msg); + } else if (process.traceDeprecation) { + console.trace(msg); + } else { + console.error(msg); + } + warned = true; + } + return fn.apply(this, arguments); + } + + return deprecated; +}; + + +var debugs = {}; +var debugEnviron; +exports.debuglog = function(set) { + if (isUndefined(debugEnviron)) + debugEnviron = process.env.NODE_DEBUG || ''; + set = set.toUpperCase(); + if (!debugs[set]) { + if (new RegExp('\\b' + set + '\\b', 'i').test(debugEnviron)) { + var pid = process.pid; + debugs[set] = function() { + var msg = exports.format.apply(exports, arguments); + console.error('%s %d: %s', set, pid, msg); + }; + } else { + debugs[set] = function() {}; + } + } + return debugs[set]; +}; + + +/** + * Echos the value of a value. Trys to print the value out + * in the best way possible given the different types. + * + * @param {Object} obj The object to print out. + * @param {Object} opts Optional options object that alters the output. + */ +/* legacy: obj, showHidden, depth, colors*/ +function inspect(obj, opts) { + // default options + var ctx = { + seen: [], + stylize: stylizeNoColor + }; + // legacy... + if (arguments.length >= 3) ctx.depth = arguments[2]; + if (arguments.length >= 4) ctx.colors = arguments[3]; + if (isBoolean(opts)) { + // legacy... + ctx.showHidden = opts; + } else if (opts) { + // got an "options" object + exports._extend(ctx, opts); + } + // set default options + if (isUndefined(ctx.showHidden)) ctx.showHidden = false; + if (isUndefined(ctx.depth)) ctx.depth = 2; + if (isUndefined(ctx.colors)) ctx.colors = false; + if (isUndefined(ctx.customInspect)) ctx.customInspect = true; + if (ctx.colors) ctx.stylize = stylizeWithColor; + return formatValue(ctx, obj, ctx.depth); +} +exports.inspect = inspect; + + +// http://en.wikipedia.org/wiki/ANSI_escape_code#graphics +inspect.colors = { + 'bold' : [1, 22], + 'italic' : [3, 23], + 'underline' : [4, 24], + 'inverse' : [7, 27], + 'white' : [37, 39], + 'grey' : [90, 39], + 'black' : [30, 39], + 'blue' : [34, 39], + 'cyan' : [36, 39], + 'green' : [32, 39], + 'magenta' : [35, 39], + 'red' : [31, 39], + 'yellow' : [33, 39] +}; + +// Don't use 'blue' not visible on cmd.exe +inspect.styles = { + 'special': 'cyan', + 'number': 'yellow', + 'boolean': 'yellow', + 'undefined': 'grey', + 'null': 'bold', + 'string': 'green', + 'date': 'magenta', + // "name": intentionally not styling + 'regexp': 'red' +}; + + +function stylizeWithColor(str, styleType) { + var style = inspect.styles[styleType]; + + if (style) { + return '\u001b[' + inspect.colors[style][0] + 'm' + str + + '\u001b[' + inspect.colors[style][1] + 'm'; + } else { + return str; + } +} + + +function stylizeNoColor(str, styleType) { + return str; +} + + +function arrayToHash(array) { + var hash = {}; + + array.forEach(function(val, idx) { + hash[val] = true; + }); + + return hash; +} + + +function formatValue(ctx, value, recurseTimes) { + // Provide a hook for user-specified inspect functions. + // Check that value is an object with an inspect function on it + if (ctx.customInspect && + value && + isFunction(value.inspect) && + // Filter out the util module, it's inspect function is special + value.inspect !== exports.inspect && + // Also filter out any prototype objects using the circular check. + !(value.constructor && value.constructor.prototype === value)) { + var ret = value.inspect(recurseTimes, ctx); + if (!isString(ret)) { + ret = formatValue(ctx, ret, recurseTimes); + } + return ret; + } + + // Primitive types cannot have properties + var primitive = formatPrimitive(ctx, value); + if (primitive) { + return primitive; + } + + // Look up the keys of the object. + var keys = Object.keys(value); + var visibleKeys = arrayToHash(keys); + + if (ctx.showHidden) { + keys = Object.getOwnPropertyNames(value); + } + + // IE doesn't make error fields non-enumerable + // http://msdn.microsoft.com/en-us/library/ie/dww52sbt(v=vs.94).aspx + if (isError(value) + && (keys.indexOf('message') >= 0 || keys.indexOf('description') >= 0)) { + return formatError(value); + } + + // Some type of object without properties can be shortcutted. + if (keys.length === 0) { + if (isFunction(value)) { + var name = value.name ? ': ' + value.name : ''; + return ctx.stylize('[Function' + name + ']', 'special'); + } + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } + if (isDate(value)) { + return ctx.stylize(Date.prototype.toString.call(value), 'date'); + } + if (isError(value)) { + return formatError(value); + } + } + + var base = '', array = false, braces = ['{', '}']; + + // Make Array say that they are Array + if (isArray(value)) { + array = true; + braces = ['[', ']']; + } + + // Make functions say that they are functions + if (isFunction(value)) { + var n = value.name ? ': ' + value.name : ''; + base = ' [Function' + n + ']'; + } + + // Make RegExps say that they are RegExps + if (isRegExp(value)) { + base = ' ' + RegExp.prototype.toString.call(value); + } + + // Make dates with properties first say the date + if (isDate(value)) { + base = ' ' + Date.prototype.toUTCString.call(value); + } + + // Make error with message first say the error + if (isError(value)) { + base = ' ' + formatError(value); + } + + if (keys.length === 0 && (!array || value.length == 0)) { + return braces[0] + base + braces[1]; + } + + if (recurseTimes < 0) { + if (isRegExp(value)) { + return ctx.stylize(RegExp.prototype.toString.call(value), 'regexp'); + } else { + return ctx.stylize('[Object]', 'special'); + } + } + + ctx.seen.push(value); + + var output; + if (array) { + output = formatArray(ctx, value, recurseTimes, visibleKeys, keys); + } else { + output = keys.map(function(key) { + return formatProperty(ctx, value, recurseTimes, visibleKeys, key, array); + }); + } + + ctx.seen.pop(); + + return reduceToSingleString(output, base, braces); +} + + +function formatPrimitive(ctx, value) { + if (isUndefined(value)) + return ctx.stylize('undefined', 'undefined'); + if (isString(value)) { + var simple = '\'' + JSON.stringify(value).replace(/^"|"$/g, '') + .replace(/'/g, "\\'") + .replace(/\\"/g, '"') + '\''; + return ctx.stylize(simple, 'string'); + } + if (isNumber(value)) + return ctx.stylize('' + value, 'number'); + if (isBoolean(value)) + return ctx.stylize('' + value, 'boolean'); + // For some reason typeof null is "object", so special case here. + if (isNull(value)) + return ctx.stylize('null', 'null'); +} + + +function formatError(value) { + return '[' + Error.prototype.toString.call(value) + ']'; +} + + +function formatArray(ctx, value, recurseTimes, visibleKeys, keys) { + var output = []; + for (var i = 0, l = value.length; i < l; ++i) { + if (hasOwnProperty(value, String(i))) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + String(i), true)); + } else { + output.push(''); + } + } + keys.forEach(function(key) { + if (!key.match(/^\d+$/)) { + output.push(formatProperty(ctx, value, recurseTimes, visibleKeys, + key, true)); + } + }); + return output; +} + + +function formatProperty(ctx, value, recurseTimes, visibleKeys, key, array) { + var name, str, desc; + desc = Object.getOwnPropertyDescriptor(value, key) || { value: value[key] }; + if (desc.get) { + if (desc.set) { + str = ctx.stylize('[Getter/Setter]', 'special'); + } else { + str = ctx.stylize('[Getter]', 'special'); + } + } else { + if (desc.set) { + str = ctx.stylize('[Setter]', 'special'); + } + } + if (!hasOwnProperty(visibleKeys, key)) { + name = '[' + key + ']'; + } + if (!str) { + if (ctx.seen.indexOf(desc.value) < 0) { + if (isNull(recurseTimes)) { + str = formatValue(ctx, desc.value, null); + } else { + str = formatValue(ctx, desc.value, recurseTimes - 1); + } + if (str.indexOf('\n') > -1) { + if (array) { + str = str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n').substr(2); + } else { + str = '\n' + str.split('\n').map(function(line) { + return ' ' + line; + }).join('\n'); + } + } + } else { + str = ctx.stylize('[Circular]', 'special'); + } + } + if (isUndefined(name)) { + if (array && key.match(/^\d+$/)) { + return str; + } + name = JSON.stringify('' + key); + if (name.match(/^"([a-zA-Z_][a-zA-Z_0-9]*)"$/)) { + name = name.substr(1, name.length - 2); + name = ctx.stylize(name, 'name'); + } else { + name = name.replace(/'/g, "\\'") + .replace(/\\"/g, '"') + .replace(/(^"|"$)/g, "'"); + name = ctx.stylize(name, 'string'); + } + } + + return name + ': ' + str; +} + + +function reduceToSingleString(output, base, braces) { + var numLinesEst = 0; + var length = output.reduce(function(prev, cur) { + numLinesEst++; + if (cur.indexOf('\n') >= 0) numLinesEst++; + return prev + cur.replace(/\u001b\[\d\d?m/g, '').length + 1; + }, 0); + + if (length > 60) { + return braces[0] + + (base === '' ? '' : base + '\n ') + + ' ' + + output.join(',\n ') + + ' ' + + braces[1]; + } + + return braces[0] + base + ' ' + output.join(', ') + ' ' + braces[1]; +} + + +// NOTE: These type checking functions intentionally don't use `instanceof` +// because it is fragile and can be easily faked with `Object.create()`. +function isArray(ar) { + return Array.isArray(ar); +} +exports.isArray = isArray; + +function isBoolean(arg) { + return typeof arg === 'boolean'; +} +exports.isBoolean = isBoolean; + +function isNull(arg) { + return arg === null; +} +exports.isNull = isNull; + +function isNullOrUndefined(arg) { + return arg == null; +} +exports.isNullOrUndefined = isNullOrUndefined; + +function isNumber(arg) { + return typeof arg === 'number'; +} +exports.isNumber = isNumber; + +function isString(arg) { + return typeof arg === 'string'; +} +exports.isString = isString; + +function isSymbol(arg) { + return typeof arg === 'symbol'; +} +exports.isSymbol = isSymbol; + +function isUndefined(arg) { + return arg === void 0; +} +exports.isUndefined = isUndefined; + +function isRegExp(re) { + return isObject(re) && objectToString(re) === '[object RegExp]'; +} +exports.isRegExp = isRegExp; + +function isObject(arg) { + return typeof arg === 'object' && arg !== null; +} +exports.isObject = isObject; + +function isDate(d) { + return isObject(d) && objectToString(d) === '[object Date]'; +} +exports.isDate = isDate; + +function isError(e) { + return isObject(e) && + (objectToString(e) === '[object Error]' || e instanceof Error); +} +exports.isError = isError; + +function isFunction(arg) { + return typeof arg === 'function'; +} +exports.isFunction = isFunction; + +function isPrimitive(arg) { + return arg === null || + typeof arg === 'boolean' || + typeof arg === 'number' || + typeof arg === 'string' || + typeof arg === 'symbol' || // ES6 symbol + typeof arg === 'undefined'; +} +exports.isPrimitive = isPrimitive; + +exports.isBuffer = require('./support/isBuffer'); + +function objectToString(o) { + return Object.prototype.toString.call(o); +} + + +function pad(n) { + return n < 10 ? '0' + n.toString(10) : n.toString(10); +} + + +var months = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', + 'Oct', 'Nov', 'Dec']; + +// 26 Feb 16:19:34 +function timestamp() { + var d = new Date(); + var time = [pad(d.getHours()), + pad(d.getMinutes()), + pad(d.getSeconds())].join(':'); + return [d.getDate(), months[d.getMonth()], time].join(' '); +} + + +// log is just a thin wrapper to console.log that prepends a timestamp +exports.log = function() { + console.log('%s - %s', timestamp(), exports.format.apply(exports, arguments)); +}; + + +/** + * Inherit the prototype methods from one constructor into another. + * + * The Function.prototype.inherits from lang.js rewritten as a standalone + * function (not on Function.prototype). NOTE: If this file is to be loaded + * during bootstrapping this function needs to be rewritten using some native + * functions as prototype setup using normal JavaScript does not work as + * expected during bootstrapping (see mirror.js in r114903). + * + * @param {function} ctor Constructor function which needs to inherit the + * prototype. + * @param {function} superCtor Constructor function to inherit prototype from. + */ +exports.inherits = require('inherits'); + +exports._extend = function(origin, add) { + // Don't do anything if add isn't an object + if (!add || !isObject(add)) return origin; + + var keys = Object.keys(add); + var i = keys.length; + while (i--) { + origin[keys[i]] = add[keys[i]]; + } + return origin; +}; + +function hasOwnProperty(obj, prop) { + return Object.prototype.hasOwnProperty.call(obj, prop); +} + +}).call(this,require('_process'),typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : typeof window !== "undefined" ? window : {}) +},{"./support/isBuffer":27,"_process":24,"inherits":26}],29:[function(require,module,exports){ +// Returns a wrapper function that returns a wrapped callback +// The wrapper function should do some stuff, and return a +// presumably different callback function. +// This makes sure that own properties are retained, so that +// decorations and such are not lost along the way. +module.exports = wrappy +function wrappy (fn, cb) { + if (fn && cb) return wrappy(fn)(cb) + + if (typeof fn !== 'function') + throw new TypeError('need wrapper function') + + Object.keys(fn).forEach(function (k) { + wrapper[k] = fn[k] + }) + + return wrapper + + function wrapper() { + var args = new Array(arguments.length) + for (var i = 0; i < args.length; i++) { + args[i] = arguments[i] + } + var ret = fn.apply(this, args) + var cb = args[args.length-1] + if (typeof ret === 'function' && ret !== cb) { + Object.keys(cb).forEach(function (k) { + ret[k] = cb[k] + }) + } + return ret + } +} + +},{}]},{},[7])(7) +}); \ No newline at end of file diff --git a/assets/javascripts/workers/search.5bf1dace.min.js b/assets/javascripts/workers/search.5bf1dace.min.js new file mode 100644 index 00000000..5b80d43c --- /dev/null +++ b/assets/javascripts/workers/search.5bf1dace.min.js @@ -0,0 +1,48 @@ +"use strict";(()=>{var ge=Object.create;var W=Object.defineProperty,ye=Object.defineProperties,me=Object.getOwnPropertyDescriptor,ve=Object.getOwnPropertyDescriptors,xe=Object.getOwnPropertyNames,G=Object.getOwnPropertySymbols,Se=Object.getPrototypeOf,X=Object.prototype.hasOwnProperty,Qe=Object.prototype.propertyIsEnumerable;var J=(t,e,r)=>e in t?W(t,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):t[e]=r,M=(t,e)=>{for(var r in e||(e={}))X.call(e,r)&&J(t,r,e[r]);if(G)for(var r of G(e))Qe.call(e,r)&&J(t,r,e[r]);return t},Z=(t,e)=>ye(t,ve(e));var K=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var be=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of xe(e))!X.call(t,i)&&i!==r&&W(t,i,{get:()=>e[i],enumerable:!(n=me(e,i))||n.enumerable});return t};var H=(t,e,r)=>(r=t!=null?ge(Se(t)):{},be(e||!t||!t.__esModule?W(r,"default",{value:t,enumerable:!0}):r,t));var z=(t,e,r)=>new Promise((n,i)=>{var s=u=>{try{a(r.next(u))}catch(c){i(c)}},o=u=>{try{a(r.throw(u))}catch(c){i(c)}},a=u=>u.done?n(u.value):Promise.resolve(u.value).then(s,o);a((r=r.apply(t,e)).next())});var re=K((ee,te)=>{/** + * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9 + * Copyright (C) 2020 Oliver Nightingale + * @license MIT + */(function(){var t=function(e){var r=new t.Builder;return r.pipeline.add(t.trimmer,t.stopWordFilter,t.stemmer),r.searchPipeline.add(t.stemmer),e.call(r,r),r.build()};t.version="2.3.9";/*! + * lunr.utils + * Copyright (C) 2020 Oliver Nightingale + */t.utils={},t.utils.warn=function(e){return function(r){e.console&&console.warn&&console.warn(r)}}(this),t.utils.asString=function(e){return e==null?"":e.toString()},t.utils.clone=function(e){if(e==null)return e;for(var r=Object.create(null),n=Object.keys(e),i=0;i0){var h=t.utils.clone(r)||{};h.position=[a,c],h.index=s.length,s.push(new t.Token(n.slice(a,o),h))}a=o+1}}return s},t.tokenizer.separator=/[\s\-]+/;/*! + * lunr.Pipeline + * Copyright (C) 2020 Oliver Nightingale + */t.Pipeline=function(){this._stack=[]},t.Pipeline.registeredFunctions=Object.create(null),t.Pipeline.registerFunction=function(e,r){r in this.registeredFunctions&&t.utils.warn("Overwriting existing registered function: "+r),e.label=r,t.Pipeline.registeredFunctions[e.label]=e},t.Pipeline.warnIfFunctionNotRegistered=function(e){var r=e.label&&e.label in this.registeredFunctions;r||t.utils.warn(`Function is not registered with pipeline. This may cause problems when serialising the index. +`,e)},t.Pipeline.load=function(e){var r=new t.Pipeline;return e.forEach(function(n){var i=t.Pipeline.registeredFunctions[n];if(i)r.add(i);else throw new Error("Cannot load unregistered function: "+n)}),r},t.Pipeline.prototype.add=function(){var e=Array.prototype.slice.call(arguments);e.forEach(function(r){t.Pipeline.warnIfFunctionNotRegistered(r),this._stack.push(r)},this)},t.Pipeline.prototype.after=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");n=n+1,this._stack.splice(n,0,r)},t.Pipeline.prototype.before=function(e,r){t.Pipeline.warnIfFunctionNotRegistered(r);var n=this._stack.indexOf(e);if(n==-1)throw new Error("Cannot find existingFn");this._stack.splice(n,0,r)},t.Pipeline.prototype.remove=function(e){var r=this._stack.indexOf(e);r!=-1&&this._stack.splice(r,1)},t.Pipeline.prototype.run=function(e){for(var r=this._stack.length,n=0;n1&&(oe&&(n=s),o!=e);)i=n-r,s=r+Math.floor(i/2),o=this.elements[s*2];if(o==e||o>e)return s*2;if(ou?h+=2:a==u&&(r+=n[c+1]*i[h+1],c+=2,h+=2);return r},t.Vector.prototype.similarity=function(e){return this.dot(e)/this.magnitude()||0},t.Vector.prototype.toArray=function(){for(var e=new Array(this.elements.length/2),r=1,n=0;r0){var o=s.str.charAt(0),a;o in s.node.edges?a=s.node.edges[o]:(a=new t.TokenSet,s.node.edges[o]=a),s.str.length==1&&(a.final=!0),i.push({node:a,editsRemaining:s.editsRemaining,str:s.str.slice(1)})}if(s.editsRemaining!=0){if("*"in s.node.edges)var u=s.node.edges["*"];else{var u=new t.TokenSet;s.node.edges["*"]=u}if(s.str.length==0&&(u.final=!0),i.push({node:u,editsRemaining:s.editsRemaining-1,str:s.str}),s.str.length>1&&i.push({node:s.node,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)}),s.str.length==1&&(s.node.final=!0),s.str.length>=1){if("*"in s.node.edges)var c=s.node.edges["*"];else{var c=new t.TokenSet;s.node.edges["*"]=c}s.str.length==1&&(c.final=!0),i.push({node:c,editsRemaining:s.editsRemaining-1,str:s.str.slice(1)})}if(s.str.length>1){var h=s.str.charAt(0),y=s.str.charAt(1),g;y in s.node.edges?g=s.node.edges[y]:(g=new t.TokenSet,s.node.edges[y]=g),s.str.length==1&&(g.final=!0),i.push({node:g,editsRemaining:s.editsRemaining-1,str:h+s.str.slice(2)})}}}return n},t.TokenSet.fromString=function(e){for(var r=new t.TokenSet,n=r,i=0,s=e.length;i=e;r--){var n=this.uncheckedNodes[r],i=n.child.toString();i in this.minimizedNodes?n.parent.edges[n.char]=this.minimizedNodes[i]:(n.child._str=i,this.minimizedNodes[i]=n.child),this.uncheckedNodes.pop()}};/*! + * lunr.Index + * Copyright (C) 2020 Oliver Nightingale + */t.Index=function(e){this.invertedIndex=e.invertedIndex,this.fieldVectors=e.fieldVectors,this.tokenSet=e.tokenSet,this.fields=e.fields,this.pipeline=e.pipeline},t.Index.prototype.search=function(e){return this.query(function(r){var n=new t.QueryParser(e,r);n.parse()})},t.Index.prototype.query=function(e){for(var r=new t.Query(this.fields),n=Object.create(null),i=Object.create(null),s=Object.create(null),o=Object.create(null),a=Object.create(null),u=0;u1?this._b=1:this._b=e},t.Builder.prototype.k1=function(e){this._k1=e},t.Builder.prototype.add=function(e,r){var n=e[this._ref],i=Object.keys(this._fields);this._documents[n]=r||{},this.documentCount+=1;for(var s=0;s=this.length)return t.QueryLexer.EOS;var e=this.str.charAt(this.pos);return this.pos+=1,e},t.QueryLexer.prototype.width=function(){return this.pos-this.start},t.QueryLexer.prototype.ignore=function(){this.start==this.pos&&(this.pos+=1),this.start=this.pos},t.QueryLexer.prototype.backup=function(){this.pos-=1},t.QueryLexer.prototype.acceptDigitRun=function(){var e,r;do e=this.next(),r=e.charCodeAt(0);while(r>47&&r<58);e!=t.QueryLexer.EOS&&this.backup()},t.QueryLexer.prototype.more=function(){return this.pos1&&(e.backup(),e.emit(t.QueryLexer.TERM)),e.ignore(),e.more())return t.QueryLexer.lexText},t.QueryLexer.lexEditDistance=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.EDIT_DISTANCE),t.QueryLexer.lexText},t.QueryLexer.lexBoost=function(e){return e.ignore(),e.acceptDigitRun(),e.emit(t.QueryLexer.BOOST),t.QueryLexer.lexText},t.QueryLexer.lexEOS=function(e){e.width()>0&&e.emit(t.QueryLexer.TERM)},t.QueryLexer.termSeparator=t.tokenizer.separator,t.QueryLexer.lexText=function(e){for(;;){var r=e.next();if(r==t.QueryLexer.EOS)return t.QueryLexer.lexEOS;if(r.charCodeAt(0)==92){e.escapeCharacter();continue}if(r==":")return t.QueryLexer.lexField;if(r=="~")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexEditDistance;if(r=="^")return e.backup(),e.width()>0&&e.emit(t.QueryLexer.TERM),t.QueryLexer.lexBoost;if(r=="+"&&e.width()===1||r=="-"&&e.width()===1)return e.emit(t.QueryLexer.PRESENCE),t.QueryLexer.lexText;if(r.match(t.QueryLexer.termSeparator))return t.QueryLexer.lexTerm}},t.QueryParser=function(e,r){this.lexer=new t.QueryLexer(e),this.query=r,this.currentClause={},this.lexemeIdx=0},t.QueryParser.prototype.parse=function(){this.lexer.run(),this.lexemes=this.lexer.lexemes;for(var e=t.QueryParser.parseClause;e;)e=e(this);return this.query},t.QueryParser.prototype.peekLexeme=function(){return this.lexemes[this.lexemeIdx]},t.QueryParser.prototype.consumeLexeme=function(){var e=this.peekLexeme();return this.lexemeIdx+=1,e},t.QueryParser.prototype.nextClause=function(){var e=this.currentClause;this.query.clause(e),this.currentClause={}},t.QueryParser.parseClause=function(e){var r=e.peekLexeme();if(r!=null)switch(r.type){case t.QueryLexer.PRESENCE:return t.QueryParser.parsePresence;case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expected either a field or a term, found "+r.type;throw r.str.length>=1&&(n+=" with value '"+r.str+"'"),new t.QueryParseError(n,r.start,r.end)}},t.QueryParser.parsePresence=function(e){var r=e.consumeLexeme();if(r!=null){switch(r.str){case"-":e.currentClause.presence=t.Query.presence.PROHIBITED;break;case"+":e.currentClause.presence=t.Query.presence.REQUIRED;break;default:var n="unrecognised presence operator'"+r.str+"'";throw new t.QueryParseError(n,r.start,r.end)}var i=e.peekLexeme();if(i==null){var n="expecting term or field, found nothing";throw new t.QueryParseError(n,r.start,r.end)}switch(i.type){case t.QueryLexer.FIELD:return t.QueryParser.parseField;case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var n="expecting term or field, found '"+i.type+"'";throw new t.QueryParseError(n,i.start,i.end)}}},t.QueryParser.parseField=function(e){var r=e.consumeLexeme();if(r!=null){if(e.query.allFields.indexOf(r.str)==-1){var n=e.query.allFields.map(function(o){return"'"+o+"'"}).join(", "),i="unrecognised field '"+r.str+"', possible fields: "+n;throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.fields=[r.str];var s=e.peekLexeme();if(s==null){var i="expecting term, found nothing";throw new t.QueryParseError(i,r.start,r.end)}switch(s.type){case t.QueryLexer.TERM:return t.QueryParser.parseTerm;default:var i="expecting term, found '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseTerm=function(e){var r=e.consumeLexeme();if(r!=null){e.currentClause.term=r.str.toLowerCase(),r.str.indexOf("*")!=-1&&(e.currentClause.usePipeline=!1);var n=e.peekLexeme();if(n==null){e.nextClause();return}switch(n.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+n.type+"'";throw new t.QueryParseError(i,n.start,n.end)}}},t.QueryParser.parseEditDistance=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="edit distance must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.editDistance=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},t.QueryParser.parseBoost=function(e){var r=e.consumeLexeme();if(r!=null){var n=parseInt(r.str,10);if(isNaN(n)){var i="boost must be numeric";throw new t.QueryParseError(i,r.start,r.end)}e.currentClause.boost=n;var s=e.peekLexeme();if(s==null){e.nextClause();return}switch(s.type){case t.QueryLexer.TERM:return e.nextClause(),t.QueryParser.parseTerm;case t.QueryLexer.FIELD:return e.nextClause(),t.QueryParser.parseField;case t.QueryLexer.EDIT_DISTANCE:return t.QueryParser.parseEditDistance;case t.QueryLexer.BOOST:return t.QueryParser.parseBoost;case t.QueryLexer.PRESENCE:return e.nextClause(),t.QueryParser.parsePresence;default:var i="Unexpected lexeme type '"+s.type+"'";throw new t.QueryParseError(i,s.start,s.end)}}},function(e,r){typeof define=="function"&&define.amd?define(r):typeof ee=="object"?te.exports=r():e.lunr=r()}(this,function(){return t})})()});var q=K((Re,ne)=>{"use strict";/*! + * escape-html + * Copyright(c) 2012-2013 TJ Holowaychuk + * Copyright(c) 2015 Andreas Lubbe + * Copyright(c) 2015 Tiancheng "Timothy" Gu + * MIT Licensed + */var Le=/["'&<>]/;ne.exports=we;function we(t){var e=""+t,r=Le.exec(e);if(!r)return e;var n,i="",s=0,o=0;for(s=r.index;s=0;r--){let n=t[r];typeof n!="object"?n=document.createTextNode(n):n.parentNode&&n.parentNode.removeChild(n),r?e.insertBefore(this.previousSibling,n):e.replaceChild(n,this)}}}));var ie=H(q());function se(t){let e=new Map,r=new Set;for(let n of t){let[i,s]=n.location.split("#"),o=n.location,a=n.title,u=n.tags,c=(0,ie.default)(n.text).replace(/\s+(?=[,.:;!?])/g,"").replace(/\s+/g," ");if(s){let h=e.get(i);r.has(h)?e.set(o,{location:o,title:a,text:c,parent:h}):(h.title=n.title,h.text=c,r.add(h))}else e.set(o,M({location:o,title:a,text:c},u&&{tags:u}))}return e}var oe=H(q());function ae(t,e){let r=new RegExp(t.separator,"img"),n=(i,s,o)=>`${s}${o}`;return i=>{i=i.replace(/[\s*+\-:~^]+/g," ").trim();let s=new RegExp(`(^|${t.separator})(${i.replace(/[|\\{}()[\]^$+*?.-]/g,"\\$&").replace(r,"|")})`,"img");return o=>(e?(0,oe.default)(o):o).replace(s,n).replace(/<\/mark>(\s+)]*>/img,"$1")}}function ue(t){let e=new lunr.Query(["title","text"]);return new lunr.QueryParser(t,e).parse(),e.clauses}function ce(t,e){var i;let r=new Set(t),n={};for(let s=0;s!n.has(i)))]}var U=class{constructor({config:e,docs:r,options:n}){this.options=n,this.documents=se(r),this.highlight=ae(e,!1),lunr.tokenizer.separator=new RegExp(e.separator),this.index=lunr(function(){e.lang.length===1&&e.lang[0]!=="en"?this.use(lunr[e.lang[0]]):e.lang.length>1&&this.use(lunr.multiLanguage(...e.lang));let i=Ee(["trimmer","stopWordFilter","stemmer"],n.pipeline);for(let s of e.lang.map(o=>o==="en"?lunr:lunr[o]))for(let o of i)this.pipeline.remove(s[o]),this.searchPipeline.remove(s[o]);this.ref("location"),this.field("title",{boost:1e3}),this.field("text"),this.field("tags",{boost:1e6,extractor:s=>{let{tags:o=[]}=s;return o.reduce((a,u)=>[...a,...lunr.tokenizer(u)],[])}});for(let s of r)this.add(s,{boost:s.boost})})}search(e){if(e)try{let r=this.highlight(e),n=ue(e).filter(o=>o.presence!==lunr.Query.presence.PROHIBITED),i=this.index.search(`${e}*`).reduce((o,{ref:a,score:u,matchData:c})=>{let h=this.documents.get(a);if(typeof h!="undefined"){let{location:y,title:g,text:b,tags:m,parent:Q}=h,p=ce(n,Object.keys(c.metadata)),d=+!Q+ +Object.values(p).every(w=>w);o.push(Z(M({location:y,title:r(g),text:r(b)},m&&{tags:m.map(r)}),{score:u*(1+d),terms:p}))}return o},[]).sort((o,a)=>a.score-o.score).reduce((o,a)=>{let u=this.documents.get(a.location);if(typeof u!="undefined"){let c="parent"in u?u.parent.location:u.location;o.set(c,[...o.get(c)||[],a])}return o},new Map),s;if(this.options.suggestions){let o=this.index.query(a=>{for(let u of n)a.term(u.term,{fields:["title"],presence:lunr.Query.presence.REQUIRED,wildcard:lunr.Query.wildcard.TRAILING})});s=o.length?Object.keys(o[0].matchData.metadata):[]}return M({items:[...i.values()]},typeof s!="undefined"&&{suggestions:s})}catch(r){console.warn(`Invalid query: ${e} \u2013 see https://bit.ly/2s3ChXG`)}return{items:[]}}};var Y;function ke(t){return z(this,null,function*(){let e="../lunr";if(typeof parent!="undefined"&&"IFrameWorker"in parent){let n=document.querySelector("script[src]"),[i]=n.src.split("/worker");e=e.replace("..",i)}let r=[];for(let n of t.lang){switch(n){case"ja":r.push(`${e}/tinyseg.js`);break;case"hi":case"th":r.push(`${e}/wordcut.js`);break}n!=="en"&&r.push(`${e}/min/lunr.${n}.min.js`)}t.lang.length>1&&r.push(`${e}/min/lunr.multi.min.js`),r.length&&(yield importScripts(`${e}/min/lunr.stemmer.support.min.js`,...r))})}function Te(t){return z(this,null,function*(){switch(t.type){case 0:return yield ke(t.data.config),Y=new U(t.data),{type:1};case 2:return{type:3,data:Y?Y.search(t.data):{items:[]}};default:throw new TypeError("Invalid message type")}})}self.lunr=le.default;addEventListener("message",t=>z(void 0,null,function*(){postMessage(yield Te(t.data))}));})(); +//# sourceMappingURL=search.5bf1dace.min.js.map + diff --git a/assets/javascripts/workers/search.5bf1dace.min.js.map b/assets/javascripts/workers/search.5bf1dace.min.js.map new file mode 100644 index 00000000..1df8be0e --- /dev/null +++ b/assets/javascripts/workers/search.5bf1dace.min.js.map @@ -0,0 +1,8 @@ +{ + "version": 3, + "sources": ["node_modules/lunr/lunr.js", "node_modules/escape-html/index.js", "src/assets/javascripts/integrations/search/worker/main/index.ts", "src/assets/javascripts/polyfills/index.ts", "src/assets/javascripts/integrations/search/document/index.ts", "src/assets/javascripts/integrations/search/highlighter/index.ts", "src/assets/javascripts/integrations/search/query/_/index.ts", "src/assets/javascripts/integrations/search/_/index.ts"], + "sourceRoot": "../../../..", + "sourcesContent": ["/**\n * lunr - http://lunrjs.com - A bit like Solr, but much smaller and not as bright - 2.3.9\n * Copyright (C) 2020 Oliver Nightingale\n * @license MIT\n */\n\n;(function(){\n\n/**\n * A convenience function for configuring and constructing\n * a new lunr Index.\n *\n * A lunr.Builder instance is created and the pipeline setup\n * with a trimmer, stop word filter and stemmer.\n *\n * This builder object is yielded to the configuration function\n * that is passed as a parameter, allowing the list of fields\n * and other builder parameters to be customised.\n *\n * All documents _must_ be added within the passed config function.\n *\n * @example\n * var idx = lunr(function () {\n * this.field('title')\n * this.field('body')\n * this.ref('id')\n *\n * documents.forEach(function (doc) {\n * this.add(doc)\n * }, this)\n * })\n *\n * @see {@link lunr.Builder}\n * @see {@link lunr.Pipeline}\n * @see {@link lunr.trimmer}\n * @see {@link lunr.stopWordFilter}\n * @see {@link lunr.stemmer}\n * @namespace {function} lunr\n */\nvar lunr = function (config) {\n var builder = new lunr.Builder\n\n builder.pipeline.add(\n lunr.trimmer,\n lunr.stopWordFilter,\n lunr.stemmer\n )\n\n builder.searchPipeline.add(\n lunr.stemmer\n )\n\n config.call(builder, builder)\n return builder.build()\n}\n\nlunr.version = \"2.3.9\"\n/*!\n * lunr.utils\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A namespace containing utils for the rest of the lunr library\n * @namespace lunr.utils\n */\nlunr.utils = {}\n\n/**\n * Print a warning message to the console.\n *\n * @param {String} message The message to be printed.\n * @memberOf lunr.utils\n * @function\n */\nlunr.utils.warn = (function (global) {\n /* eslint-disable no-console */\n return function (message) {\n if (global.console && console.warn) {\n console.warn(message)\n }\n }\n /* eslint-enable no-console */\n})(this)\n\n/**\n * Convert an object to a string.\n *\n * In the case of `null` and `undefined` the function returns\n * the empty string, in all other cases the result of calling\n * `toString` on the passed object is returned.\n *\n * @param {Any} obj The object to convert to a string.\n * @return {String} string representation of the passed object.\n * @memberOf lunr.utils\n */\nlunr.utils.asString = function (obj) {\n if (obj === void 0 || obj === null) {\n return \"\"\n } else {\n return obj.toString()\n }\n}\n\n/**\n * Clones an object.\n *\n * Will create a copy of an existing object such that any mutations\n * on the copy cannot affect the original.\n *\n * Only shallow objects are supported, passing a nested object to this\n * function will cause a TypeError.\n *\n * Objects with primitives, and arrays of primitives are supported.\n *\n * @param {Object} obj The object to clone.\n * @return {Object} a clone of the passed object.\n * @throws {TypeError} when a nested object is passed.\n * @memberOf Utils\n */\nlunr.utils.clone = function (obj) {\n if (obj === null || obj === undefined) {\n return obj\n }\n\n var clone = Object.create(null),\n keys = Object.keys(obj)\n\n for (var i = 0; i < keys.length; i++) {\n var key = keys[i],\n val = obj[key]\n\n if (Array.isArray(val)) {\n clone[key] = val.slice()\n continue\n }\n\n if (typeof val === 'string' ||\n typeof val === 'number' ||\n typeof val === 'boolean') {\n clone[key] = val\n continue\n }\n\n throw new TypeError(\"clone is not deep and does not support nested objects\")\n }\n\n return clone\n}\nlunr.FieldRef = function (docRef, fieldName, stringValue) {\n this.docRef = docRef\n this.fieldName = fieldName\n this._stringValue = stringValue\n}\n\nlunr.FieldRef.joiner = \"/\"\n\nlunr.FieldRef.fromString = function (s) {\n var n = s.indexOf(lunr.FieldRef.joiner)\n\n if (n === -1) {\n throw \"malformed field ref string\"\n }\n\n var fieldRef = s.slice(0, n),\n docRef = s.slice(n + 1)\n\n return new lunr.FieldRef (docRef, fieldRef, s)\n}\n\nlunr.FieldRef.prototype.toString = function () {\n if (this._stringValue == undefined) {\n this._stringValue = this.fieldName + lunr.FieldRef.joiner + this.docRef\n }\n\n return this._stringValue\n}\n/*!\n * lunr.Set\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A lunr set.\n *\n * @constructor\n */\nlunr.Set = function (elements) {\n this.elements = Object.create(null)\n\n if (elements) {\n this.length = elements.length\n\n for (var i = 0; i < this.length; i++) {\n this.elements[elements[i]] = true\n }\n } else {\n this.length = 0\n }\n}\n\n/**\n * A complete set that contains all elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.complete = {\n intersect: function (other) {\n return other\n },\n\n union: function () {\n return this\n },\n\n contains: function () {\n return true\n }\n}\n\n/**\n * An empty set that contains no elements.\n *\n * @static\n * @readonly\n * @type {lunr.Set}\n */\nlunr.Set.empty = {\n intersect: function () {\n return this\n },\n\n union: function (other) {\n return other\n },\n\n contains: function () {\n return false\n }\n}\n\n/**\n * Returns true if this set contains the specified object.\n *\n * @param {object} object - Object whose presence in this set is to be tested.\n * @returns {boolean} - True if this set contains the specified object.\n */\nlunr.Set.prototype.contains = function (object) {\n return !!this.elements[object]\n}\n\n/**\n * Returns a new set containing only the elements that are present in both\n * this set and the specified set.\n *\n * @param {lunr.Set} other - set to intersect with this set.\n * @returns {lunr.Set} a new set that is the intersection of this and the specified set.\n */\n\nlunr.Set.prototype.intersect = function (other) {\n var a, b, elements, intersection = []\n\n if (other === lunr.Set.complete) {\n return this\n }\n\n if (other === lunr.Set.empty) {\n return other\n }\n\n if (this.length < other.length) {\n a = this\n b = other\n } else {\n a = other\n b = this\n }\n\n elements = Object.keys(a.elements)\n\n for (var i = 0; i < elements.length; i++) {\n var element = elements[i]\n if (element in b.elements) {\n intersection.push(element)\n }\n }\n\n return new lunr.Set (intersection)\n}\n\n/**\n * Returns a new set combining the elements of this and the specified set.\n *\n * @param {lunr.Set} other - set to union with this set.\n * @return {lunr.Set} a new set that is the union of this and the specified set.\n */\n\nlunr.Set.prototype.union = function (other) {\n if (other === lunr.Set.complete) {\n return lunr.Set.complete\n }\n\n if (other === lunr.Set.empty) {\n return this\n }\n\n return new lunr.Set(Object.keys(this.elements).concat(Object.keys(other.elements)))\n}\n/**\n * A function to calculate the inverse document frequency for\n * a posting. This is shared between the builder and the index\n *\n * @private\n * @param {object} posting - The posting for a given term\n * @param {number} documentCount - The total number of documents.\n */\nlunr.idf = function (posting, documentCount) {\n var documentsWithTerm = 0\n\n for (var fieldName in posting) {\n if (fieldName == '_index') continue // Ignore the term index, its not a field\n documentsWithTerm += Object.keys(posting[fieldName]).length\n }\n\n var x = (documentCount - documentsWithTerm + 0.5) / (documentsWithTerm + 0.5)\n\n return Math.log(1 + Math.abs(x))\n}\n\n/**\n * A token wraps a string representation of a token\n * as it is passed through the text processing pipeline.\n *\n * @constructor\n * @param {string} [str=''] - The string token being wrapped.\n * @param {object} [metadata={}] - Metadata associated with this token.\n */\nlunr.Token = function (str, metadata) {\n this.str = str || \"\"\n this.metadata = metadata || {}\n}\n\n/**\n * Returns the token string that is being wrapped by this object.\n *\n * @returns {string}\n */\nlunr.Token.prototype.toString = function () {\n return this.str\n}\n\n/**\n * A token update function is used when updating or optionally\n * when cloning a token.\n *\n * @callback lunr.Token~updateFunction\n * @param {string} str - The string representation of the token.\n * @param {Object} metadata - All metadata associated with this token.\n */\n\n/**\n * Applies the given function to the wrapped string token.\n *\n * @example\n * token.update(function (str, metadata) {\n * return str.toUpperCase()\n * })\n *\n * @param {lunr.Token~updateFunction} fn - A function to apply to the token string.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.update = function (fn) {\n this.str = fn(this.str, this.metadata)\n return this\n}\n\n/**\n * Creates a clone of this token. Optionally a function can be\n * applied to the cloned token.\n *\n * @param {lunr.Token~updateFunction} [fn] - An optional function to apply to the cloned token.\n * @returns {lunr.Token}\n */\nlunr.Token.prototype.clone = function (fn) {\n fn = fn || function (s) { return s }\n return new lunr.Token (fn(this.str, this.metadata), this.metadata)\n}\n/*!\n * lunr.tokenizer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A function for splitting a string into tokens ready to be inserted into\n * the search index. Uses `lunr.tokenizer.separator` to split strings, change\n * the value of this property to change how strings are split into tokens.\n *\n * This tokenizer will convert its parameter to a string by calling `toString` and\n * then will split this string on the character in `lunr.tokenizer.separator`.\n * Arrays will have their elements converted to strings and wrapped in a lunr.Token.\n *\n * Optional metadata can be passed to the tokenizer, this metadata will be cloned and\n * added as metadata to every token that is created from the object to be tokenized.\n *\n * @static\n * @param {?(string|object|object[])} obj - The object to convert into tokens\n * @param {?object} metadata - Optional metadata to associate with every token\n * @returns {lunr.Token[]}\n * @see {@link lunr.Pipeline}\n */\nlunr.tokenizer = function (obj, metadata) {\n if (obj == null || obj == undefined) {\n return []\n }\n\n if (Array.isArray(obj)) {\n return obj.map(function (t) {\n return new lunr.Token(\n lunr.utils.asString(t).toLowerCase(),\n lunr.utils.clone(metadata)\n )\n })\n }\n\n var str = obj.toString().toLowerCase(),\n len = str.length,\n tokens = []\n\n for (var sliceEnd = 0, sliceStart = 0; sliceEnd <= len; sliceEnd++) {\n var char = str.charAt(sliceEnd),\n sliceLength = sliceEnd - sliceStart\n\n if ((char.match(lunr.tokenizer.separator) || sliceEnd == len)) {\n\n if (sliceLength > 0) {\n var tokenMetadata = lunr.utils.clone(metadata) || {}\n tokenMetadata[\"position\"] = [sliceStart, sliceLength]\n tokenMetadata[\"index\"] = tokens.length\n\n tokens.push(\n new lunr.Token (\n str.slice(sliceStart, sliceEnd),\n tokenMetadata\n )\n )\n }\n\n sliceStart = sliceEnd + 1\n }\n\n }\n\n return tokens\n}\n\n/**\n * The separator used to split a string into tokens. Override this property to change the behaviour of\n * `lunr.tokenizer` behaviour when tokenizing strings. By default this splits on whitespace and hyphens.\n *\n * @static\n * @see lunr.tokenizer\n */\nlunr.tokenizer.separator = /[\\s\\-]+/\n/*!\n * lunr.Pipeline\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Pipelines maintain an ordered list of functions to be applied to all\n * tokens in documents entering the search index and queries being ran against\n * the index.\n *\n * An instance of lunr.Index created with the lunr shortcut will contain a\n * pipeline with a stop word filter and an English language stemmer. Extra\n * functions can be added before or after either of these functions or these\n * default functions can be removed.\n *\n * When run the pipeline will call each function in turn, passing a token, the\n * index of that token in the original list of all tokens and finally a list of\n * all the original tokens.\n *\n * The output of functions in the pipeline will be passed to the next function\n * in the pipeline. To exclude a token from entering the index the function\n * should return undefined, the rest of the pipeline will not be called with\n * this token.\n *\n * For serialisation of pipelines to work, all functions used in an instance of\n * a pipeline should be registered with lunr.Pipeline. Registered functions can\n * then be loaded. If trying to load a serialised pipeline that uses functions\n * that are not registered an error will be thrown.\n *\n * If not planning on serialising the pipeline then registering pipeline functions\n * is not necessary.\n *\n * @constructor\n */\nlunr.Pipeline = function () {\n this._stack = []\n}\n\nlunr.Pipeline.registeredFunctions = Object.create(null)\n\n/**\n * A pipeline function maps lunr.Token to lunr.Token. A lunr.Token contains the token\n * string as well as all known metadata. A pipeline function can mutate the token string\n * or mutate (or add) metadata for a given token.\n *\n * A pipeline function can indicate that the passed token should be discarded by returning\n * null, undefined or an empty string. This token will not be passed to any downstream pipeline\n * functions and will not be added to the index.\n *\n * Multiple tokens can be returned by returning an array of tokens. Each token will be passed\n * to any downstream pipeline functions and all will returned tokens will be added to the index.\n *\n * Any number of pipeline functions may be chained together using a lunr.Pipeline.\n *\n * @interface lunr.PipelineFunction\n * @param {lunr.Token} token - A token from the document being processed.\n * @param {number} i - The index of this token in the complete list of tokens for this document/field.\n * @param {lunr.Token[]} tokens - All tokens for this document/field.\n * @returns {(?lunr.Token|lunr.Token[])}\n */\n\n/**\n * Register a function with the pipeline.\n *\n * Functions that are used in the pipeline should be registered if the pipeline\n * needs to be serialised, or a serialised pipeline needs to be loaded.\n *\n * Registering a function does not add it to a pipeline, functions must still be\n * added to instances of the pipeline for them to be used when running a pipeline.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @param {String} label - The label to register this function with\n */\nlunr.Pipeline.registerFunction = function (fn, label) {\n if (label in this.registeredFunctions) {\n lunr.utils.warn('Overwriting existing registered function: ' + label)\n }\n\n fn.label = label\n lunr.Pipeline.registeredFunctions[fn.label] = fn\n}\n\n/**\n * Warns if the function is not registered as a Pipeline function.\n *\n * @param {lunr.PipelineFunction} fn - The function to check for.\n * @private\n */\nlunr.Pipeline.warnIfFunctionNotRegistered = function (fn) {\n var isRegistered = fn.label && (fn.label in this.registeredFunctions)\n\n if (!isRegistered) {\n lunr.utils.warn('Function is not registered with pipeline. This may cause problems when serialising the index.\\n', fn)\n }\n}\n\n/**\n * Loads a previously serialised pipeline.\n *\n * All functions to be loaded must already be registered with lunr.Pipeline.\n * If any function from the serialised data has not been registered then an\n * error will be thrown.\n *\n * @param {Object} serialised - The serialised pipeline to load.\n * @returns {lunr.Pipeline}\n */\nlunr.Pipeline.load = function (serialised) {\n var pipeline = new lunr.Pipeline\n\n serialised.forEach(function (fnName) {\n var fn = lunr.Pipeline.registeredFunctions[fnName]\n\n if (fn) {\n pipeline.add(fn)\n } else {\n throw new Error('Cannot load unregistered function: ' + fnName)\n }\n })\n\n return pipeline\n}\n\n/**\n * Adds new functions to the end of the pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction[]} functions - Any number of functions to add to the pipeline.\n */\nlunr.Pipeline.prototype.add = function () {\n var fns = Array.prototype.slice.call(arguments)\n\n fns.forEach(function (fn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n this._stack.push(fn)\n }, this)\n}\n\n/**\n * Adds a single function after a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.after = function (existingFn, newFn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n var pos = this._stack.indexOf(existingFn)\n if (pos == -1) {\n throw new Error('Cannot find existingFn')\n }\n\n pos = pos + 1\n this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Adds a single function before a function that already exists in the\n * pipeline.\n *\n * Logs a warning if the function has not been registered.\n *\n * @param {lunr.PipelineFunction} existingFn - A function that already exists in the pipeline.\n * @param {lunr.PipelineFunction} newFn - The new function to add to the pipeline.\n */\nlunr.Pipeline.prototype.before = function (existingFn, newFn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(newFn)\n\n var pos = this._stack.indexOf(existingFn)\n if (pos == -1) {\n throw new Error('Cannot find existingFn')\n }\n\n this._stack.splice(pos, 0, newFn)\n}\n\n/**\n * Removes a function from the pipeline.\n *\n * @param {lunr.PipelineFunction} fn The function to remove from the pipeline.\n */\nlunr.Pipeline.prototype.remove = function (fn) {\n var pos = this._stack.indexOf(fn)\n if (pos == -1) {\n return\n }\n\n this._stack.splice(pos, 1)\n}\n\n/**\n * Runs the current list of functions that make up the pipeline against the\n * passed tokens.\n *\n * @param {Array} tokens The tokens to run through the pipeline.\n * @returns {Array}\n */\nlunr.Pipeline.prototype.run = function (tokens) {\n var stackLength = this._stack.length\n\n for (var i = 0; i < stackLength; i++) {\n var fn = this._stack[i]\n var memo = []\n\n for (var j = 0; j < tokens.length; j++) {\n var result = fn(tokens[j], j, tokens)\n\n if (result === null || result === void 0 || result === '') continue\n\n if (Array.isArray(result)) {\n for (var k = 0; k < result.length; k++) {\n memo.push(result[k])\n }\n } else {\n memo.push(result)\n }\n }\n\n tokens = memo\n }\n\n return tokens\n}\n\n/**\n * Convenience method for passing a string through a pipeline and getting\n * strings out. This method takes care of wrapping the passed string in a\n * token and mapping the resulting tokens back to strings.\n *\n * @param {string} str - The string to pass through the pipeline.\n * @param {?object} metadata - Optional metadata to associate with the token\n * passed to the pipeline.\n * @returns {string[]}\n */\nlunr.Pipeline.prototype.runString = function (str, metadata) {\n var token = new lunr.Token (str, metadata)\n\n return this.run([token]).map(function (t) {\n return t.toString()\n })\n}\n\n/**\n * Resets the pipeline by removing any existing processors.\n *\n */\nlunr.Pipeline.prototype.reset = function () {\n this._stack = []\n}\n\n/**\n * Returns a representation of the pipeline ready for serialisation.\n *\n * Logs a warning if the function has not been registered.\n *\n * @returns {Array}\n */\nlunr.Pipeline.prototype.toJSON = function () {\n return this._stack.map(function (fn) {\n lunr.Pipeline.warnIfFunctionNotRegistered(fn)\n\n return fn.label\n })\n}\n/*!\n * lunr.Vector\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A vector is used to construct the vector space of documents and queries. These\n * vectors support operations to determine the similarity between two documents or\n * a document and a query.\n *\n * Normally no parameters are required for initializing a vector, but in the case of\n * loading a previously dumped vector the raw elements can be provided to the constructor.\n *\n * For performance reasons vectors are implemented with a flat array, where an elements\n * index is immediately followed by its value. E.g. [index, value, index, value]. This\n * allows the underlying array to be as sparse as possible and still offer decent\n * performance when being used for vector calculations.\n *\n * @constructor\n * @param {Number[]} [elements] - The flat list of element index and element value pairs.\n */\nlunr.Vector = function (elements) {\n this._magnitude = 0\n this.elements = elements || []\n}\n\n\n/**\n * Calculates the position within the vector to insert a given index.\n *\n * This is used internally by insert and upsert. If there are duplicate indexes then\n * the position is returned as if the value for that index were to be updated, but it\n * is the callers responsibility to check whether there is a duplicate at that index\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @returns {Number}\n */\nlunr.Vector.prototype.positionForIndex = function (index) {\n // For an empty vector the tuple can be inserted at the beginning\n if (this.elements.length == 0) {\n return 0\n }\n\n var start = 0,\n end = this.elements.length / 2,\n sliceLength = end - start,\n pivotPoint = Math.floor(sliceLength / 2),\n pivotIndex = this.elements[pivotPoint * 2]\n\n while (sliceLength > 1) {\n if (pivotIndex < index) {\n start = pivotPoint\n }\n\n if (pivotIndex > index) {\n end = pivotPoint\n }\n\n if (pivotIndex == index) {\n break\n }\n\n sliceLength = end - start\n pivotPoint = start + Math.floor(sliceLength / 2)\n pivotIndex = this.elements[pivotPoint * 2]\n }\n\n if (pivotIndex == index) {\n return pivotPoint * 2\n }\n\n if (pivotIndex > index) {\n return pivotPoint * 2\n }\n\n if (pivotIndex < index) {\n return (pivotPoint + 1) * 2\n }\n}\n\n/**\n * Inserts an element at an index within the vector.\n *\n * Does not allow duplicates, will throw an error if there is already an entry\n * for this index.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n */\nlunr.Vector.prototype.insert = function (insertIdx, val) {\n this.upsert(insertIdx, val, function () {\n throw \"duplicate index\"\n })\n}\n\n/**\n * Inserts or updates an existing index within the vector.\n *\n * @param {Number} insertIdx - The index at which the element should be inserted.\n * @param {Number} val - The value to be inserted into the vector.\n * @param {function} fn - A function that is called for updates, the existing value and the\n * requested value are passed as arguments\n */\nlunr.Vector.prototype.upsert = function (insertIdx, val, fn) {\n this._magnitude = 0\n var position = this.positionForIndex(insertIdx)\n\n if (this.elements[position] == insertIdx) {\n this.elements[position + 1] = fn(this.elements[position + 1], val)\n } else {\n this.elements.splice(position, 0, insertIdx, val)\n }\n}\n\n/**\n * Calculates the magnitude of this vector.\n *\n * @returns {Number}\n */\nlunr.Vector.prototype.magnitude = function () {\n if (this._magnitude) return this._magnitude\n\n var sumOfSquares = 0,\n elementsLength = this.elements.length\n\n for (var i = 1; i < elementsLength; i += 2) {\n var val = this.elements[i]\n sumOfSquares += val * val\n }\n\n return this._magnitude = Math.sqrt(sumOfSquares)\n}\n\n/**\n * Calculates the dot product of this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The vector to compute the dot product with.\n * @returns {Number}\n */\nlunr.Vector.prototype.dot = function (otherVector) {\n var dotProduct = 0,\n a = this.elements, b = otherVector.elements,\n aLen = a.length, bLen = b.length,\n aVal = 0, bVal = 0,\n i = 0, j = 0\n\n while (i < aLen && j < bLen) {\n aVal = a[i], bVal = b[j]\n if (aVal < bVal) {\n i += 2\n } else if (aVal > bVal) {\n j += 2\n } else if (aVal == bVal) {\n dotProduct += a[i + 1] * b[j + 1]\n i += 2\n j += 2\n }\n }\n\n return dotProduct\n}\n\n/**\n * Calculates the similarity between this vector and another vector.\n *\n * @param {lunr.Vector} otherVector - The other vector to calculate the\n * similarity with.\n * @returns {Number}\n */\nlunr.Vector.prototype.similarity = function (otherVector) {\n return this.dot(otherVector) / this.magnitude() || 0\n}\n\n/**\n * Converts the vector to an array of the elements within the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toArray = function () {\n var output = new Array (this.elements.length / 2)\n\n for (var i = 1, j = 0; i < this.elements.length; i += 2, j++) {\n output[j] = this.elements[i]\n }\n\n return output\n}\n\n/**\n * A JSON serializable representation of the vector.\n *\n * @returns {Number[]}\n */\nlunr.Vector.prototype.toJSON = function () {\n return this.elements\n}\n/* eslint-disable */\n/*!\n * lunr.stemmer\n * Copyright (C) 2020 Oliver Nightingale\n * Includes code from - http://tartarus.org/~martin/PorterStemmer/js.txt\n */\n\n/**\n * lunr.stemmer is an english language stemmer, this is a JavaScript\n * implementation of the PorterStemmer taken from http://tartarus.org/~martin\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token - The string to stem\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n * @function\n */\nlunr.stemmer = (function(){\n var step2list = {\n \"ational\" : \"ate\",\n \"tional\" : \"tion\",\n \"enci\" : \"ence\",\n \"anci\" : \"ance\",\n \"izer\" : \"ize\",\n \"bli\" : \"ble\",\n \"alli\" : \"al\",\n \"entli\" : \"ent\",\n \"eli\" : \"e\",\n \"ousli\" : \"ous\",\n \"ization\" : \"ize\",\n \"ation\" : \"ate\",\n \"ator\" : \"ate\",\n \"alism\" : \"al\",\n \"iveness\" : \"ive\",\n \"fulness\" : \"ful\",\n \"ousness\" : \"ous\",\n \"aliti\" : \"al\",\n \"iviti\" : \"ive\",\n \"biliti\" : \"ble\",\n \"logi\" : \"log\"\n },\n\n step3list = {\n \"icate\" : \"ic\",\n \"ative\" : \"\",\n \"alize\" : \"al\",\n \"iciti\" : \"ic\",\n \"ical\" : \"ic\",\n \"ful\" : \"\",\n \"ness\" : \"\"\n },\n\n c = \"[^aeiou]\", // consonant\n v = \"[aeiouy]\", // vowel\n C = c + \"[^aeiouy]*\", // consonant sequence\n V = v + \"[aeiou]*\", // vowel sequence\n\n mgr0 = \"^(\" + C + \")?\" + V + C, // [C]VC... is m>0\n meq1 = \"^(\" + C + \")?\" + V + C + \"(\" + V + \")?$\", // [C]VC[V] is m=1\n mgr1 = \"^(\" + C + \")?\" + V + C + V + C, // [C]VCVC... is m>1\n s_v = \"^(\" + C + \")?\" + v; // vowel in stem\n\n var re_mgr0 = new RegExp(mgr0);\n var re_mgr1 = new RegExp(mgr1);\n var re_meq1 = new RegExp(meq1);\n var re_s_v = new RegExp(s_v);\n\n var re_1a = /^(.+?)(ss|i)es$/;\n var re2_1a = /^(.+?)([^s])s$/;\n var re_1b = /^(.+?)eed$/;\n var re2_1b = /^(.+?)(ed|ing)$/;\n var re_1b_2 = /.$/;\n var re2_1b_2 = /(at|bl|iz)$/;\n var re3_1b_2 = new RegExp(\"([^aeiouylsz])\\\\1$\");\n var re4_1b_2 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n var re_1c = /^(.+?[^aeiou])y$/;\n var re_2 = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/;\n\n var re_3 = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/;\n\n var re_4 = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/;\n var re2_4 = /^(.+?)(s|t)(ion)$/;\n\n var re_5 = /^(.+?)e$/;\n var re_5_1 = /ll$/;\n var re3_5 = new RegExp(\"^\" + C + v + \"[^aeiouwxy]$\");\n\n var porterStemmer = function porterStemmer(w) {\n var stem,\n suffix,\n firstch,\n re,\n re2,\n re3,\n re4;\n\n if (w.length < 3) { return w; }\n\n firstch = w.substr(0,1);\n if (firstch == \"y\") {\n w = firstch.toUpperCase() + w.substr(1);\n }\n\n // Step 1a\n re = re_1a\n re2 = re2_1a;\n\n if (re.test(w)) { w = w.replace(re,\"$1$2\"); }\n else if (re2.test(w)) { w = w.replace(re2,\"$1$2\"); }\n\n // Step 1b\n re = re_1b;\n re2 = re2_1b;\n if (re.test(w)) {\n var fp = re.exec(w);\n re = re_mgr0;\n if (re.test(fp[1])) {\n re = re_1b_2;\n w = w.replace(re,\"\");\n }\n } else if (re2.test(w)) {\n var fp = re2.exec(w);\n stem = fp[1];\n re2 = re_s_v;\n if (re2.test(stem)) {\n w = stem;\n re2 = re2_1b_2;\n re3 = re3_1b_2;\n re4 = re4_1b_2;\n if (re2.test(w)) { w = w + \"e\"; }\n else if (re3.test(w)) { re = re_1b_2; w = w.replace(re,\"\"); }\n else if (re4.test(w)) { w = w + \"e\"; }\n }\n }\n\n // Step 1c - replace suffix y or Y by i if preceded by a non-vowel which is not the first letter of the word (so cry -> cri, by -> by, say -> say)\n re = re_1c;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n w = stem + \"i\";\n }\n\n // Step 2\n re = re_2;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n suffix = fp[2];\n re = re_mgr0;\n if (re.test(stem)) {\n w = stem + step2list[suffix];\n }\n }\n\n // Step 3\n re = re_3;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n suffix = fp[2];\n re = re_mgr0;\n if (re.test(stem)) {\n w = stem + step3list[suffix];\n }\n }\n\n // Step 4\n re = re_4;\n re2 = re2_4;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n re = re_mgr1;\n if (re.test(stem)) {\n w = stem;\n }\n } else if (re2.test(w)) {\n var fp = re2.exec(w);\n stem = fp[1] + fp[2];\n re2 = re_mgr1;\n if (re2.test(stem)) {\n w = stem;\n }\n }\n\n // Step 5\n re = re_5;\n if (re.test(w)) {\n var fp = re.exec(w);\n stem = fp[1];\n re = re_mgr1;\n re2 = re_meq1;\n re3 = re3_5;\n if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) {\n w = stem;\n }\n }\n\n re = re_5_1;\n re2 = re_mgr1;\n if (re.test(w) && re2.test(w)) {\n re = re_1b_2;\n w = w.replace(re,\"\");\n }\n\n // and turn initial Y back to y\n\n if (firstch == \"y\") {\n w = firstch.toLowerCase() + w.substr(1);\n }\n\n return w;\n };\n\n return function (token) {\n return token.update(porterStemmer);\n }\n})();\n\nlunr.Pipeline.registerFunction(lunr.stemmer, 'stemmer')\n/*!\n * lunr.stopWordFilter\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.generateStopWordFilter builds a stopWordFilter function from the provided\n * list of stop words.\n *\n * The built in lunr.stopWordFilter is built using this generator and can be used\n * to generate custom stopWordFilters for applications or non English languages.\n *\n * @function\n * @param {Array} token The token to pass through the filter\n * @returns {lunr.PipelineFunction}\n * @see lunr.Pipeline\n * @see lunr.stopWordFilter\n */\nlunr.generateStopWordFilter = function (stopWords) {\n var words = stopWords.reduce(function (memo, stopWord) {\n memo[stopWord] = stopWord\n return memo\n }, {})\n\n return function (token) {\n if (token && words[token.toString()] !== token.toString()) return token\n }\n}\n\n/**\n * lunr.stopWordFilter is an English language stop word list filter, any words\n * contained in the list will not be passed through the filter.\n *\n * This is intended to be used in the Pipeline. If the token does not pass the\n * filter then undefined will be returned.\n *\n * @function\n * @implements {lunr.PipelineFunction}\n * @params {lunr.Token} token - A token to check for being a stop word.\n * @returns {lunr.Token}\n * @see {@link lunr.Pipeline}\n */\nlunr.stopWordFilter = lunr.generateStopWordFilter([\n 'a',\n 'able',\n 'about',\n 'across',\n 'after',\n 'all',\n 'almost',\n 'also',\n 'am',\n 'among',\n 'an',\n 'and',\n 'any',\n 'are',\n 'as',\n 'at',\n 'be',\n 'because',\n 'been',\n 'but',\n 'by',\n 'can',\n 'cannot',\n 'could',\n 'dear',\n 'did',\n 'do',\n 'does',\n 'either',\n 'else',\n 'ever',\n 'every',\n 'for',\n 'from',\n 'get',\n 'got',\n 'had',\n 'has',\n 'have',\n 'he',\n 'her',\n 'hers',\n 'him',\n 'his',\n 'how',\n 'however',\n 'i',\n 'if',\n 'in',\n 'into',\n 'is',\n 'it',\n 'its',\n 'just',\n 'least',\n 'let',\n 'like',\n 'likely',\n 'may',\n 'me',\n 'might',\n 'most',\n 'must',\n 'my',\n 'neither',\n 'no',\n 'nor',\n 'not',\n 'of',\n 'off',\n 'often',\n 'on',\n 'only',\n 'or',\n 'other',\n 'our',\n 'own',\n 'rather',\n 'said',\n 'say',\n 'says',\n 'she',\n 'should',\n 'since',\n 'so',\n 'some',\n 'than',\n 'that',\n 'the',\n 'their',\n 'them',\n 'then',\n 'there',\n 'these',\n 'they',\n 'this',\n 'tis',\n 'to',\n 'too',\n 'twas',\n 'us',\n 'wants',\n 'was',\n 'we',\n 'were',\n 'what',\n 'when',\n 'where',\n 'which',\n 'while',\n 'who',\n 'whom',\n 'why',\n 'will',\n 'with',\n 'would',\n 'yet',\n 'you',\n 'your'\n])\n\nlunr.Pipeline.registerFunction(lunr.stopWordFilter, 'stopWordFilter')\n/*!\n * lunr.trimmer\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.trimmer is a pipeline function for trimming non word\n * characters from the beginning and end of tokens before they\n * enter the index.\n *\n * This implementation may not work correctly for non latin\n * characters and should either be removed or adapted for use\n * with languages with non-latin characters.\n *\n * @static\n * @implements {lunr.PipelineFunction}\n * @param {lunr.Token} token The token to pass through the filter\n * @returns {lunr.Token}\n * @see lunr.Pipeline\n */\nlunr.trimmer = function (token) {\n return token.update(function (s) {\n return s.replace(/^\\W+/, '').replace(/\\W+$/, '')\n })\n}\n\nlunr.Pipeline.registerFunction(lunr.trimmer, 'trimmer')\n/*!\n * lunr.TokenSet\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * A token set is used to store the unique list of all tokens\n * within an index. Token sets are also used to represent an\n * incoming query to the index, this query token set and index\n * token set are then intersected to find which tokens to look\n * up in the inverted index.\n *\n * A token set can hold multiple tokens, as in the case of the\n * index token set, or it can hold a single token as in the\n * case of a simple query token set.\n *\n * Additionally token sets are used to perform wildcard matching.\n * Leading, contained and trailing wildcards are supported, and\n * from this edit distance matching can also be provided.\n *\n * Token sets are implemented as a minimal finite state automata,\n * where both common prefixes and suffixes are shared between tokens.\n * This helps to reduce the space used for storing the token set.\n *\n * @constructor\n */\nlunr.TokenSet = function () {\n this.final = false\n this.edges = {}\n this.id = lunr.TokenSet._nextId\n lunr.TokenSet._nextId += 1\n}\n\n/**\n * Keeps track of the next, auto increment, identifier to assign\n * to a new tokenSet.\n *\n * TokenSets require a unique identifier to be correctly minimised.\n *\n * @private\n */\nlunr.TokenSet._nextId = 1\n\n/**\n * Creates a TokenSet instance from the given sorted array of words.\n *\n * @param {String[]} arr - A sorted array of strings to create the set from.\n * @returns {lunr.TokenSet}\n * @throws Will throw an error if the input array is not sorted.\n */\nlunr.TokenSet.fromArray = function (arr) {\n var builder = new lunr.TokenSet.Builder\n\n for (var i = 0, len = arr.length; i < len; i++) {\n builder.insert(arr[i])\n }\n\n builder.finish()\n return builder.root\n}\n\n/**\n * Creates a token set from a query clause.\n *\n * @private\n * @param {Object} clause - A single clause from lunr.Query.\n * @param {string} clause.term - The query clause term.\n * @param {number} [clause.editDistance] - The optional edit distance for the term.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromClause = function (clause) {\n if ('editDistance' in clause) {\n return lunr.TokenSet.fromFuzzyString(clause.term, clause.editDistance)\n } else {\n return lunr.TokenSet.fromString(clause.term)\n }\n}\n\n/**\n * Creates a token set representing a single string with a specified\n * edit distance.\n *\n * Insertions, deletions, substitutions and transpositions are each\n * treated as an edit distance of 1.\n *\n * Increasing the allowed edit distance will have a dramatic impact\n * on the performance of both creating and intersecting these TokenSets.\n * It is advised to keep the edit distance less than 3.\n *\n * @param {string} str - The string to create the token set from.\n * @param {number} editDistance - The allowed edit distance to match.\n * @returns {lunr.Vector}\n */\nlunr.TokenSet.fromFuzzyString = function (str, editDistance) {\n var root = new lunr.TokenSet\n\n var stack = [{\n node: root,\n editsRemaining: editDistance,\n str: str\n }]\n\n while (stack.length) {\n var frame = stack.pop()\n\n // no edit\n if (frame.str.length > 0) {\n var char = frame.str.charAt(0),\n noEditNode\n\n if (char in frame.node.edges) {\n noEditNode = frame.node.edges[char]\n } else {\n noEditNode = new lunr.TokenSet\n frame.node.edges[char] = noEditNode\n }\n\n if (frame.str.length == 1) {\n noEditNode.final = true\n }\n\n stack.push({\n node: noEditNode,\n editsRemaining: frame.editsRemaining,\n str: frame.str.slice(1)\n })\n }\n\n if (frame.editsRemaining == 0) {\n continue\n }\n\n // insertion\n if (\"*\" in frame.node.edges) {\n var insertionNode = frame.node.edges[\"*\"]\n } else {\n var insertionNode = new lunr.TokenSet\n frame.node.edges[\"*\"] = insertionNode\n }\n\n if (frame.str.length == 0) {\n insertionNode.final = true\n }\n\n stack.push({\n node: insertionNode,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str\n })\n\n // deletion\n // can only do a deletion if we have enough edits remaining\n // and if there are characters left to delete in the string\n if (frame.str.length > 1) {\n stack.push({\n node: frame.node,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str.slice(1)\n })\n }\n\n // deletion\n // just removing the last character from the str\n if (frame.str.length == 1) {\n frame.node.final = true\n }\n\n // substitution\n // can only do a substitution if we have enough edits remaining\n // and if there are characters left to substitute\n if (frame.str.length >= 1) {\n if (\"*\" in frame.node.edges) {\n var substitutionNode = frame.node.edges[\"*\"]\n } else {\n var substitutionNode = new lunr.TokenSet\n frame.node.edges[\"*\"] = substitutionNode\n }\n\n if (frame.str.length == 1) {\n substitutionNode.final = true\n }\n\n stack.push({\n node: substitutionNode,\n editsRemaining: frame.editsRemaining - 1,\n str: frame.str.slice(1)\n })\n }\n\n // transposition\n // can only do a transposition if there are edits remaining\n // and there are enough characters to transpose\n if (frame.str.length > 1) {\n var charA = frame.str.charAt(0),\n charB = frame.str.charAt(1),\n transposeNode\n\n if (charB in frame.node.edges) {\n transposeNode = frame.node.edges[charB]\n } else {\n transposeNode = new lunr.TokenSet\n frame.node.edges[charB] = transposeNode\n }\n\n if (frame.str.length == 1) {\n transposeNode.final = true\n }\n\n stack.push({\n node: transposeNode,\n editsRemaining: frame.editsRemaining - 1,\n str: charA + frame.str.slice(2)\n })\n }\n }\n\n return root\n}\n\n/**\n * Creates a TokenSet from a string.\n *\n * The string may contain one or more wildcard characters (*)\n * that will allow wildcard matching when intersecting with\n * another TokenSet.\n *\n * @param {string} str - The string to create a TokenSet from.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.fromString = function (str) {\n var node = new lunr.TokenSet,\n root = node\n\n /*\n * Iterates through all characters within the passed string\n * appending a node for each character.\n *\n * When a wildcard character is found then a self\n * referencing edge is introduced to continually match\n * any number of any characters.\n */\n for (var i = 0, len = str.length; i < len; i++) {\n var char = str[i],\n final = (i == len - 1)\n\n if (char == \"*\") {\n node.edges[char] = node\n node.final = final\n\n } else {\n var next = new lunr.TokenSet\n next.final = final\n\n node.edges[char] = next\n node = next\n }\n }\n\n return root\n}\n\n/**\n * Converts this TokenSet into an array of strings\n * contained within the TokenSet.\n *\n * This is not intended to be used on a TokenSet that\n * contains wildcards, in these cases the results are\n * undefined and are likely to cause an infinite loop.\n *\n * @returns {string[]}\n */\nlunr.TokenSet.prototype.toArray = function () {\n var words = []\n\n var stack = [{\n prefix: \"\",\n node: this\n }]\n\n while (stack.length) {\n var frame = stack.pop(),\n edges = Object.keys(frame.node.edges),\n len = edges.length\n\n if (frame.node.final) {\n /* In Safari, at this point the prefix is sometimes corrupted, see:\n * https://github.com/olivernn/lunr.js/issues/279 Calling any\n * String.prototype method forces Safari to \"cast\" this string to what\n * it's supposed to be, fixing the bug. */\n frame.prefix.charAt(0)\n words.push(frame.prefix)\n }\n\n for (var i = 0; i < len; i++) {\n var edge = edges[i]\n\n stack.push({\n prefix: frame.prefix.concat(edge),\n node: frame.node.edges[edge]\n })\n }\n }\n\n return words\n}\n\n/**\n * Generates a string representation of a TokenSet.\n *\n * This is intended to allow TokenSets to be used as keys\n * in objects, largely to aid the construction and minimisation\n * of a TokenSet. As such it is not designed to be a human\n * friendly representation of the TokenSet.\n *\n * @returns {string}\n */\nlunr.TokenSet.prototype.toString = function () {\n // NOTE: Using Object.keys here as this.edges is very likely\n // to enter 'hash-mode' with many keys being added\n //\n // avoiding a for-in loop here as it leads to the function\n // being de-optimised (at least in V8). From some simple\n // benchmarks the performance is comparable, but allowing\n // V8 to optimize may mean easy performance wins in the future.\n\n if (this._str) {\n return this._str\n }\n\n var str = this.final ? '1' : '0',\n labels = Object.keys(this.edges).sort(),\n len = labels.length\n\n for (var i = 0; i < len; i++) {\n var label = labels[i],\n node = this.edges[label]\n\n str = str + label + node.id\n }\n\n return str\n}\n\n/**\n * Returns a new TokenSet that is the intersection of\n * this TokenSet and the passed TokenSet.\n *\n * This intersection will take into account any wildcards\n * contained within the TokenSet.\n *\n * @param {lunr.TokenSet} b - An other TokenSet to intersect with.\n * @returns {lunr.TokenSet}\n */\nlunr.TokenSet.prototype.intersect = function (b) {\n var output = new lunr.TokenSet,\n frame = undefined\n\n var stack = [{\n qNode: b,\n output: output,\n node: this\n }]\n\n while (stack.length) {\n frame = stack.pop()\n\n // NOTE: As with the #toString method, we are using\n // Object.keys and a for loop instead of a for-in loop\n // as both of these objects enter 'hash' mode, causing\n // the function to be de-optimised in V8\n var qEdges = Object.keys(frame.qNode.edges),\n qLen = qEdges.length,\n nEdges = Object.keys(frame.node.edges),\n nLen = nEdges.length\n\n for (var q = 0; q < qLen; q++) {\n var qEdge = qEdges[q]\n\n for (var n = 0; n < nLen; n++) {\n var nEdge = nEdges[n]\n\n if (nEdge == qEdge || qEdge == '*') {\n var node = frame.node.edges[nEdge],\n qNode = frame.qNode.edges[qEdge],\n final = node.final && qNode.final,\n next = undefined\n\n if (nEdge in frame.output.edges) {\n // an edge already exists for this character\n // no need to create a new node, just set the finality\n // bit unless this node is already final\n next = frame.output.edges[nEdge]\n next.final = next.final || final\n\n } else {\n // no edge exists yet, must create one\n // set the finality bit and insert it\n // into the output\n next = new lunr.TokenSet\n next.final = final\n frame.output.edges[nEdge] = next\n }\n\n stack.push({\n qNode: qNode,\n output: next,\n node: node\n })\n }\n }\n }\n }\n\n return output\n}\nlunr.TokenSet.Builder = function () {\n this.previousWord = \"\"\n this.root = new lunr.TokenSet\n this.uncheckedNodes = []\n this.minimizedNodes = {}\n}\n\nlunr.TokenSet.Builder.prototype.insert = function (word) {\n var node,\n commonPrefix = 0\n\n if (word < this.previousWord) {\n throw new Error (\"Out of order word insertion\")\n }\n\n for (var i = 0; i < word.length && i < this.previousWord.length; i++) {\n if (word[i] != this.previousWord[i]) break\n commonPrefix++\n }\n\n this.minimize(commonPrefix)\n\n if (this.uncheckedNodes.length == 0) {\n node = this.root\n } else {\n node = this.uncheckedNodes[this.uncheckedNodes.length - 1].child\n }\n\n for (var i = commonPrefix; i < word.length; i++) {\n var nextNode = new lunr.TokenSet,\n char = word[i]\n\n node.edges[char] = nextNode\n\n this.uncheckedNodes.push({\n parent: node,\n char: char,\n child: nextNode\n })\n\n node = nextNode\n }\n\n node.final = true\n this.previousWord = word\n}\n\nlunr.TokenSet.Builder.prototype.finish = function () {\n this.minimize(0)\n}\n\nlunr.TokenSet.Builder.prototype.minimize = function (downTo) {\n for (var i = this.uncheckedNodes.length - 1; i >= downTo; i--) {\n var node = this.uncheckedNodes[i],\n childKey = node.child.toString()\n\n if (childKey in this.minimizedNodes) {\n node.parent.edges[node.char] = this.minimizedNodes[childKey]\n } else {\n // Cache the key for this node since\n // we know it can't change anymore\n node.child._str = childKey\n\n this.minimizedNodes[childKey] = node.child\n }\n\n this.uncheckedNodes.pop()\n }\n}\n/*!\n * lunr.Index\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * An index contains the built index of all documents and provides a query interface\n * to the index.\n *\n * Usually instances of lunr.Index will not be created using this constructor, instead\n * lunr.Builder should be used to construct new indexes, or lunr.Index.load should be\n * used to load previously built and serialized indexes.\n *\n * @constructor\n * @param {Object} attrs - The attributes of the built search index.\n * @param {Object} attrs.invertedIndex - An index of term/field to document reference.\n * @param {Object} attrs.fieldVectors - Field vectors\n * @param {lunr.TokenSet} attrs.tokenSet - An set of all corpus tokens.\n * @param {string[]} attrs.fields - The names of indexed document fields.\n * @param {lunr.Pipeline} attrs.pipeline - The pipeline to use for search terms.\n */\nlunr.Index = function (attrs) {\n this.invertedIndex = attrs.invertedIndex\n this.fieldVectors = attrs.fieldVectors\n this.tokenSet = attrs.tokenSet\n this.fields = attrs.fields\n this.pipeline = attrs.pipeline\n}\n\n/**\n * A result contains details of a document matching a search query.\n * @typedef {Object} lunr.Index~Result\n * @property {string} ref - The reference of the document this result represents.\n * @property {number} score - A number between 0 and 1 representing how similar this document is to the query.\n * @property {lunr.MatchData} matchData - Contains metadata about this match including which term(s) caused the match.\n */\n\n/**\n * Although lunr provides the ability to create queries using lunr.Query, it also provides a simple\n * query language which itself is parsed into an instance of lunr.Query.\n *\n * For programmatically building queries it is advised to directly use lunr.Query, the query language\n * is best used for human entered text rather than program generated text.\n *\n * At its simplest queries can just be a single term, e.g. `hello`, multiple terms are also supported\n * and will be combined with OR, e.g `hello world` will match documents that contain either 'hello'\n * or 'world', though those that contain both will rank higher in the results.\n *\n * Wildcards can be included in terms to match one or more unspecified characters, these wildcards can\n * be inserted anywhere within the term, and more than one wildcard can exist in a single term. Adding\n * wildcards will increase the number of documents that will be found but can also have a negative\n * impact on query performance, especially with wildcards at the beginning of a term.\n *\n * Terms can be restricted to specific fields, e.g. `title:hello`, only documents with the term\n * hello in the title field will match this query. Using a field not present in the index will lead\n * to an error being thrown.\n *\n * Modifiers can also be added to terms, lunr supports edit distance and boost modifiers on terms. A term\n * boost will make documents matching that term score higher, e.g. `foo^5`. Edit distance is also supported\n * to provide fuzzy matching, e.g. 'hello~2' will match documents with hello with an edit distance of 2.\n * Avoid large values for edit distance to improve query performance.\n *\n * Each term also supports a presence modifier. By default a term's presence in document is optional, however\n * this can be changed to either required or prohibited. For a term's presence to be required in a document the\n * term should be prefixed with a '+', e.g. `+foo bar` is a search for documents that must contain 'foo' and\n * optionally contain 'bar'. Conversely a leading '-' sets the terms presence to prohibited, i.e. it must not\n * appear in a document, e.g. `-foo bar` is a search for documents that do not contain 'foo' but may contain 'bar'.\n *\n * To escape special characters the backslash character '\\' can be used, this allows searches to include\n * characters that would normally be considered modifiers, e.g. `foo\\~2` will search for a term \"foo~2\" instead\n * of attempting to apply a boost of 2 to the search term \"foo\".\n *\n * @typedef {string} lunr.Index~QueryString\n * @example Simple single term query\n * hello\n * @example Multiple term query\n * hello world\n * @example term scoped to a field\n * title:hello\n * @example term with a boost of 10\n * hello^10\n * @example term with an edit distance of 2\n * hello~2\n * @example terms with presence modifiers\n * -foo +bar baz\n */\n\n/**\n * Performs a search against the index using lunr query syntax.\n *\n * Results will be returned sorted by their score, the most relevant results\n * will be returned first. For details on how the score is calculated, please see\n * the {@link https://lunrjs.com/guides/searching.html#scoring|guide}.\n *\n * For more programmatic querying use lunr.Index#query.\n *\n * @param {lunr.Index~QueryString} queryString - A string containing a lunr query.\n * @throws {lunr.QueryParseError} If the passed query string cannot be parsed.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.search = function (queryString) {\n return this.query(function (query) {\n var parser = new lunr.QueryParser(queryString, query)\n parser.parse()\n })\n}\n\n/**\n * A query builder callback provides a query object to be used to express\n * the query to perform on the index.\n *\n * @callback lunr.Index~queryBuilder\n * @param {lunr.Query} query - The query object to build up.\n * @this lunr.Query\n */\n\n/**\n * Performs a query against the index using the yielded lunr.Query object.\n *\n * If performing programmatic queries against the index, this method is preferred\n * over lunr.Index#search so as to avoid the additional query parsing overhead.\n *\n * A query object is yielded to the supplied function which should be used to\n * express the query to be run against the index.\n *\n * Note that although this function takes a callback parameter it is _not_ an\n * asynchronous operation, the callback is just yielded a query object to be\n * customized.\n *\n * @param {lunr.Index~queryBuilder} fn - A function that is used to build the query.\n * @returns {lunr.Index~Result[]}\n */\nlunr.Index.prototype.query = function (fn) {\n // for each query clause\n // * process terms\n // * expand terms from token set\n // * find matching documents and metadata\n // * get document vectors\n // * score documents\n\n var query = new lunr.Query(this.fields),\n matchingFields = Object.create(null),\n queryVectors = Object.create(null),\n termFieldCache = Object.create(null),\n requiredMatches = Object.create(null),\n prohibitedMatches = Object.create(null)\n\n /*\n * To support field level boosts a query vector is created per\n * field. An empty vector is eagerly created to support negated\n * queries.\n */\n for (var i = 0; i < this.fields.length; i++) {\n queryVectors[this.fields[i]] = new lunr.Vector\n }\n\n fn.call(query, query)\n\n for (var i = 0; i < query.clauses.length; i++) {\n /*\n * Unless the pipeline has been disabled for this term, which is\n * the case for terms with wildcards, we need to pass the clause\n * term through the search pipeline. A pipeline returns an array\n * of processed terms. Pipeline functions may expand the passed\n * term, which means we may end up performing multiple index lookups\n * for a single query term.\n */\n var clause = query.clauses[i],\n terms = null,\n clauseMatches = lunr.Set.empty\n\n if (clause.usePipeline) {\n terms = this.pipeline.runString(clause.term, {\n fields: clause.fields\n })\n } else {\n terms = [clause.term]\n }\n\n for (var m = 0; m < terms.length; m++) {\n var term = terms[m]\n\n /*\n * Each term returned from the pipeline needs to use the same query\n * clause object, e.g. the same boost and or edit distance. The\n * simplest way to do this is to re-use the clause object but mutate\n * its term property.\n */\n clause.term = term\n\n /*\n * From the term in the clause we create a token set which will then\n * be used to intersect the indexes token set to get a list of terms\n * to lookup in the inverted index\n */\n var termTokenSet = lunr.TokenSet.fromClause(clause),\n expandedTerms = this.tokenSet.intersect(termTokenSet).toArray()\n\n /*\n * If a term marked as required does not exist in the tokenSet it is\n * impossible for the search to return any matches. We set all the field\n * scoped required matches set to empty and stop examining any further\n * clauses.\n */\n if (expandedTerms.length === 0 && clause.presence === lunr.Query.presence.REQUIRED) {\n for (var k = 0; k < clause.fields.length; k++) {\n var field = clause.fields[k]\n requiredMatches[field] = lunr.Set.empty\n }\n\n break\n }\n\n for (var j = 0; j < expandedTerms.length; j++) {\n /*\n * For each term get the posting and termIndex, this is required for\n * building the query vector.\n */\n var expandedTerm = expandedTerms[j],\n posting = this.invertedIndex[expandedTerm],\n termIndex = posting._index\n\n for (var k = 0; k < clause.fields.length; k++) {\n /*\n * For each field that this query term is scoped by (by default\n * all fields are in scope) we need to get all the document refs\n * that have this term in that field.\n *\n * The posting is the entry in the invertedIndex for the matching\n * term from above.\n */\n var field = clause.fields[k],\n fieldPosting = posting[field],\n matchingDocumentRefs = Object.keys(fieldPosting),\n termField = expandedTerm + \"/\" + field,\n matchingDocumentsSet = new lunr.Set(matchingDocumentRefs)\n\n /*\n * if the presence of this term is required ensure that the matching\n * documents are added to the set of required matches for this clause.\n *\n */\n if (clause.presence == lunr.Query.presence.REQUIRED) {\n clauseMatches = clauseMatches.union(matchingDocumentsSet)\n\n if (requiredMatches[field] === undefined) {\n requiredMatches[field] = lunr.Set.complete\n }\n }\n\n /*\n * if the presence of this term is prohibited ensure that the matching\n * documents are added to the set of prohibited matches for this field,\n * creating that set if it does not yet exist.\n */\n if (clause.presence == lunr.Query.presence.PROHIBITED) {\n if (prohibitedMatches[field] === undefined) {\n prohibitedMatches[field] = lunr.Set.empty\n }\n\n prohibitedMatches[field] = prohibitedMatches[field].union(matchingDocumentsSet)\n\n /*\n * Prohibited matches should not be part of the query vector used for\n * similarity scoring and no metadata should be extracted so we continue\n * to the next field\n */\n continue\n }\n\n /*\n * The query field vector is populated using the termIndex found for\n * the term and a unit value with the appropriate boost applied.\n * Using upsert because there could already be an entry in the vector\n * for the term we are working with. In that case we just add the scores\n * together.\n */\n queryVectors[field].upsert(termIndex, clause.boost, function (a, b) { return a + b })\n\n /**\n * If we've already seen this term, field combo then we've already collected\n * the matching documents and metadata, no need to go through all that again\n */\n if (termFieldCache[termField]) {\n continue\n }\n\n for (var l = 0; l < matchingDocumentRefs.length; l++) {\n /*\n * All metadata for this term/field/document triple\n * are then extracted and collected into an instance\n * of lunr.MatchData ready to be returned in the query\n * results\n */\n var matchingDocumentRef = matchingDocumentRefs[l],\n matchingFieldRef = new lunr.FieldRef (matchingDocumentRef, field),\n metadata = fieldPosting[matchingDocumentRef],\n fieldMatch\n\n if ((fieldMatch = matchingFields[matchingFieldRef]) === undefined) {\n matchingFields[matchingFieldRef] = new lunr.MatchData (expandedTerm, field, metadata)\n } else {\n fieldMatch.add(expandedTerm, field, metadata)\n }\n\n }\n\n termFieldCache[termField] = true\n }\n }\n }\n\n /**\n * If the presence was required we need to update the requiredMatches field sets.\n * We do this after all fields for the term have collected their matches because\n * the clause terms presence is required in _any_ of the fields not _all_ of the\n * fields.\n */\n if (clause.presence === lunr.Query.presence.REQUIRED) {\n for (var k = 0; k < clause.fields.length; k++) {\n var field = clause.fields[k]\n requiredMatches[field] = requiredMatches[field].intersect(clauseMatches)\n }\n }\n }\n\n /**\n * Need to combine the field scoped required and prohibited\n * matching documents into a global set of required and prohibited\n * matches\n */\n var allRequiredMatches = lunr.Set.complete,\n allProhibitedMatches = lunr.Set.empty\n\n for (var i = 0; i < this.fields.length; i++) {\n var field = this.fields[i]\n\n if (requiredMatches[field]) {\n allRequiredMatches = allRequiredMatches.intersect(requiredMatches[field])\n }\n\n if (prohibitedMatches[field]) {\n allProhibitedMatches = allProhibitedMatches.union(prohibitedMatches[field])\n }\n }\n\n var matchingFieldRefs = Object.keys(matchingFields),\n results = [],\n matches = Object.create(null)\n\n /*\n * If the query is negated (contains only prohibited terms)\n * we need to get _all_ fieldRefs currently existing in the\n * index. This is only done when we know that the query is\n * entirely prohibited terms to avoid any cost of getting all\n * fieldRefs unnecessarily.\n *\n * Additionally, blank MatchData must be created to correctly\n * populate the results.\n */\n if (query.isNegated()) {\n matchingFieldRefs = Object.keys(this.fieldVectors)\n\n for (var i = 0; i < matchingFieldRefs.length; i++) {\n var matchingFieldRef = matchingFieldRefs[i]\n var fieldRef = lunr.FieldRef.fromString(matchingFieldRef)\n matchingFields[matchingFieldRef] = new lunr.MatchData\n }\n }\n\n for (var i = 0; i < matchingFieldRefs.length; i++) {\n /*\n * Currently we have document fields that match the query, but we\n * need to return documents. The matchData and scores are combined\n * from multiple fields belonging to the same document.\n *\n * Scores are calculated by field, using the query vectors created\n * above, and combined into a final document score using addition.\n */\n var fieldRef = lunr.FieldRef.fromString(matchingFieldRefs[i]),\n docRef = fieldRef.docRef\n\n if (!allRequiredMatches.contains(docRef)) {\n continue\n }\n\n if (allProhibitedMatches.contains(docRef)) {\n continue\n }\n\n var fieldVector = this.fieldVectors[fieldRef],\n score = queryVectors[fieldRef.fieldName].similarity(fieldVector),\n docMatch\n\n if ((docMatch = matches[docRef]) !== undefined) {\n docMatch.score += score\n docMatch.matchData.combine(matchingFields[fieldRef])\n } else {\n var match = {\n ref: docRef,\n score: score,\n matchData: matchingFields[fieldRef]\n }\n matches[docRef] = match\n results.push(match)\n }\n }\n\n /*\n * Sort the results objects by score, highest first.\n */\n return results.sort(function (a, b) {\n return b.score - a.score\n })\n}\n\n/**\n * Prepares the index for JSON serialization.\n *\n * The schema for this JSON blob will be described in a\n * separate JSON schema file.\n *\n * @returns {Object}\n */\nlunr.Index.prototype.toJSON = function () {\n var invertedIndex = Object.keys(this.invertedIndex)\n .sort()\n .map(function (term) {\n return [term, this.invertedIndex[term]]\n }, this)\n\n var fieldVectors = Object.keys(this.fieldVectors)\n .map(function (ref) {\n return [ref, this.fieldVectors[ref].toJSON()]\n }, this)\n\n return {\n version: lunr.version,\n fields: this.fields,\n fieldVectors: fieldVectors,\n invertedIndex: invertedIndex,\n pipeline: this.pipeline.toJSON()\n }\n}\n\n/**\n * Loads a previously serialized lunr.Index\n *\n * @param {Object} serializedIndex - A previously serialized lunr.Index\n * @returns {lunr.Index}\n */\nlunr.Index.load = function (serializedIndex) {\n var attrs = {},\n fieldVectors = {},\n serializedVectors = serializedIndex.fieldVectors,\n invertedIndex = Object.create(null),\n serializedInvertedIndex = serializedIndex.invertedIndex,\n tokenSetBuilder = new lunr.TokenSet.Builder,\n pipeline = lunr.Pipeline.load(serializedIndex.pipeline)\n\n if (serializedIndex.version != lunr.version) {\n lunr.utils.warn(\"Version mismatch when loading serialised index. Current version of lunr '\" + lunr.version + \"' does not match serialized index '\" + serializedIndex.version + \"'\")\n }\n\n for (var i = 0; i < serializedVectors.length; i++) {\n var tuple = serializedVectors[i],\n ref = tuple[0],\n elements = tuple[1]\n\n fieldVectors[ref] = new lunr.Vector(elements)\n }\n\n for (var i = 0; i < serializedInvertedIndex.length; i++) {\n var tuple = serializedInvertedIndex[i],\n term = tuple[0],\n posting = tuple[1]\n\n tokenSetBuilder.insert(term)\n invertedIndex[term] = posting\n }\n\n tokenSetBuilder.finish()\n\n attrs.fields = serializedIndex.fields\n\n attrs.fieldVectors = fieldVectors\n attrs.invertedIndex = invertedIndex\n attrs.tokenSet = tokenSetBuilder.root\n attrs.pipeline = pipeline\n\n return new lunr.Index(attrs)\n}\n/*!\n * lunr.Builder\n * Copyright (C) 2020 Oliver Nightingale\n */\n\n/**\n * lunr.Builder performs indexing on a set of documents and\n * returns instances of lunr.Index ready for querying.\n *\n * All configuration of the index is done via the builder, the\n * fields to index, the document reference, the text processing\n * pipeline and document scoring parameters are all set on the\n * builder before indexing.\n *\n * @constructor\n * @property {string} _ref - Internal reference to the document reference field.\n * @property {string[]} _fields - Internal reference to the document fields to index.\n * @property {object} invertedIndex - The inverted index maps terms to document fields.\n * @property {object} documentTermFrequencies - Keeps track of document term frequencies.\n * @property {object} documentLengths - Keeps track of the length of documents added to the index.\n * @property {lunr.tokenizer} tokenizer - Function for splitting strings into tokens for indexing.\n * @property {lunr.Pipeline} pipeline - The pipeline performs text processing on tokens before indexing.\n * @property {lunr.Pipeline} searchPipeline - A pipeline for processing search terms before querying the index.\n * @property {number} documentCount - Keeps track of the total number of documents indexed.\n * @property {number} _b - A parameter to control field length normalization, setting this to 0 disabled normalization, 1 fully normalizes field lengths, the default value is 0.75.\n * @property {number} _k1 - A parameter to control how quickly an increase in term frequency results in term frequency saturation, the default value is 1.2.\n * @property {number} termIndex - A counter incremented for each unique term, used to identify a terms position in the vector space.\n * @property {array} metadataWhitelist - A list of metadata keys that have been whitelisted for entry in the index.\n */\nlunr.Builder = function () {\n this._ref = \"id\"\n this._fields = Object.create(null)\n this._documents = Object.create(null)\n this.invertedIndex = Object.create(null)\n this.fieldTermFrequencies = {}\n this.fieldLengths = {}\n this.tokenizer = lunr.tokenizer\n this.pipeline = new lunr.Pipeline\n this.searchPipeline = new lunr.Pipeline\n this.documentCount = 0\n this._b = 0.75\n this._k1 = 1.2\n this.termIndex = 0\n this.metadataWhitelist = []\n}\n\n/**\n * Sets the document field used as the document reference. Every document must have this field.\n * The type of this field in the document should be a string, if it is not a string it will be\n * coerced into a string by calling toString.\n *\n * The default ref is 'id'.\n *\n * The ref should _not_ be changed during indexing, it should be set before any documents are\n * added to the index. Changing it during indexing can lead to inconsistent results.\n *\n * @param {string} ref - The name of the reference field in the document.\n */\nlunr.Builder.prototype.ref = function (ref) {\n this._ref = ref\n}\n\n/**\n * A function that is used to extract a field from a document.\n *\n * Lunr expects a field to be at the top level of a document, if however the field\n * is deeply nested within a document an extractor function can be used to extract\n * the right field for indexing.\n *\n * @callback fieldExtractor\n * @param {object} doc - The document being added to the index.\n * @returns {?(string|object|object[])} obj - The object that will be indexed for this field.\n * @example Extracting a nested field\n * function (doc) { return doc.nested.field }\n */\n\n/**\n * Adds a field to the list of document fields that will be indexed. Every document being\n * indexed should have this field. Null values for this field in indexed documents will\n * not cause errors but will limit the chance of that document being retrieved by searches.\n *\n * All fields should be added before adding documents to the index. Adding fields after\n * a document has been indexed will have no effect on already indexed documents.\n *\n * Fields can be boosted at build time. This allows terms within that field to have more\n * importance when ranking search results. Use a field boost to specify that matches within\n * one field are more important than other fields.\n *\n * @param {string} fieldName - The name of a field to index in all documents.\n * @param {object} attributes - Optional attributes associated with this field.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this field.\n * @param {fieldExtractor} [attributes.extractor] - Function to extract a field from a document.\n * @throws {RangeError} fieldName cannot contain unsupported characters '/'\n */\nlunr.Builder.prototype.field = function (fieldName, attributes) {\n if (/\\//.test(fieldName)) {\n throw new RangeError (\"Field '\" + fieldName + \"' contains illegal character '/'\")\n }\n\n this._fields[fieldName] = attributes || {}\n}\n\n/**\n * A parameter to tune the amount of field length normalisation that is applied when\n * calculating relevance scores. A value of 0 will completely disable any normalisation\n * and a value of 1 will fully normalise field lengths. The default is 0.75. Values of b\n * will be clamped to the range 0 - 1.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.b = function (number) {\n if (number < 0) {\n this._b = 0\n } else if (number > 1) {\n this._b = 1\n } else {\n this._b = number\n }\n}\n\n/**\n * A parameter that controls the speed at which a rise in term frequency results in term\n * frequency saturation. The default value is 1.2. Setting this to a higher value will give\n * slower saturation levels, a lower value will result in quicker saturation.\n *\n * @param {number} number - The value to set for this tuning parameter.\n */\nlunr.Builder.prototype.k1 = function (number) {\n this._k1 = number\n}\n\n/**\n * Adds a document to the index.\n *\n * Before adding fields to the index the index should have been fully setup, with the document\n * ref and all fields to index already having been specified.\n *\n * The document must have a field name as specified by the ref (by default this is 'id') and\n * it should have all fields defined for indexing, though null or undefined values will not\n * cause errors.\n *\n * Entire documents can be boosted at build time. Applying a boost to a document indicates that\n * this document should rank higher in search results than other documents.\n *\n * @param {object} doc - The document to add to the index.\n * @param {object} attributes - Optional attributes associated with this document.\n * @param {number} [attributes.boost=1] - Boost applied to all terms within this document.\n */\nlunr.Builder.prototype.add = function (doc, attributes) {\n var docRef = doc[this._ref],\n fields = Object.keys(this._fields)\n\n this._documents[docRef] = attributes || {}\n this.documentCount += 1\n\n for (var i = 0; i < fields.length; i++) {\n var fieldName = fields[i],\n extractor = this._fields[fieldName].extractor,\n field = extractor ? extractor(doc) : doc[fieldName],\n tokens = this.tokenizer(field, {\n fields: [fieldName]\n }),\n terms = this.pipeline.run(tokens),\n fieldRef = new lunr.FieldRef (docRef, fieldName),\n fieldTerms = Object.create(null)\n\n this.fieldTermFrequencies[fieldRef] = fieldTerms\n this.fieldLengths[fieldRef] = 0\n\n // store the length of this field for this document\n this.fieldLengths[fieldRef] += terms.length\n\n // calculate term frequencies for this field\n for (var j = 0; j < terms.length; j++) {\n var term = terms[j]\n\n if (fieldTerms[term] == undefined) {\n fieldTerms[term] = 0\n }\n\n fieldTerms[term] += 1\n\n // add to inverted index\n // create an initial posting if one doesn't exist\n if (this.invertedIndex[term] == undefined) {\n var posting = Object.create(null)\n posting[\"_index\"] = this.termIndex\n this.termIndex += 1\n\n for (var k = 0; k < fields.length; k++) {\n posting[fields[k]] = Object.create(null)\n }\n\n this.invertedIndex[term] = posting\n }\n\n // add an entry for this term/fieldName/docRef to the invertedIndex\n if (this.invertedIndex[term][fieldName][docRef] == undefined) {\n this.invertedIndex[term][fieldName][docRef] = Object.create(null)\n }\n\n // store all whitelisted metadata about this token in the\n // inverted index\n for (var l = 0; l < this.metadataWhitelist.length; l++) {\n var metadataKey = this.metadataWhitelist[l],\n metadata = term.metadata[metadataKey]\n\n if (this.invertedIndex[term][fieldName][docRef][metadataKey] == undefined) {\n this.invertedIndex[term][fieldName][docRef][metadataKey] = []\n }\n\n this.invertedIndex[term][fieldName][docRef][metadataKey].push(metadata)\n }\n }\n\n }\n}\n\n/**\n * Calculates the average document length for this index\n *\n * @private\n */\nlunr.Builder.prototype.calculateAverageFieldLengths = function () {\n\n var fieldRefs = Object.keys(this.fieldLengths),\n numberOfFields = fieldRefs.length,\n accumulator = {},\n documentsWithField = {}\n\n for (var i = 0; i < numberOfFields; i++) {\n var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n field = fieldRef.fieldName\n\n documentsWithField[field] || (documentsWithField[field] = 0)\n documentsWithField[field] += 1\n\n accumulator[field] || (accumulator[field] = 0)\n accumulator[field] += this.fieldLengths[fieldRef]\n }\n\n var fields = Object.keys(this._fields)\n\n for (var i = 0; i < fields.length; i++) {\n var fieldName = fields[i]\n accumulator[fieldName] = accumulator[fieldName] / documentsWithField[fieldName]\n }\n\n this.averageFieldLength = accumulator\n}\n\n/**\n * Builds a vector space model of every document using lunr.Vector\n *\n * @private\n */\nlunr.Builder.prototype.createFieldVectors = function () {\n var fieldVectors = {},\n fieldRefs = Object.keys(this.fieldTermFrequencies),\n fieldRefsLength = fieldRefs.length,\n termIdfCache = Object.create(null)\n\n for (var i = 0; i < fieldRefsLength; i++) {\n var fieldRef = lunr.FieldRef.fromString(fieldRefs[i]),\n fieldName = fieldRef.fieldName,\n fieldLength = this.fieldLengths[fieldRef],\n fieldVector = new lunr.Vector,\n termFrequencies = this.fieldTermFrequencies[fieldRef],\n terms = Object.keys(termFrequencies),\n termsLength = terms.length\n\n\n var fieldBoost = this._fields[fieldName].boost || 1,\n docBoost = this._documents[fieldRef.docRef].boost || 1\n\n for (var j = 0; j < termsLength; j++) {\n var term = terms[j],\n tf = termFrequencies[term],\n termIndex = this.invertedIndex[term]._index,\n idf, score, scoreWithPrecision\n\n if (termIdfCache[term] === undefined) {\n idf = lunr.idf(this.invertedIndex[term], this.documentCount)\n termIdfCache[term] = idf\n } else {\n idf = termIdfCache[term]\n }\n\n score = idf * ((this._k1 + 1) * tf) / (this._k1 * (1 - this._b + this._b * (fieldLength / this.averageFieldLength[fieldName])) + tf)\n score *= fieldBoost\n score *= docBoost\n scoreWithPrecision = Math.round(score * 1000) / 1000\n // Converts 1.23456789 to 1.234.\n // Reducing the precision so that the vectors take up less\n // space when serialised. Doing it now so that they behave\n // the same before and after serialisation. Also, this is\n // the fastest approach to reducing a number's precision in\n // JavaScript.\n\n fieldVector.insert(termIndex, scoreWithPrecision)\n }\n\n fieldVectors[fieldRef] = fieldVector\n }\n\n this.fieldVectors = fieldVectors\n}\n\n/**\n * Creates a token set of all tokens in the index using lunr.TokenSet\n *\n * @private\n */\nlunr.Builder.prototype.createTokenSet = function () {\n this.tokenSet = lunr.TokenSet.fromArray(\n Object.keys(this.invertedIndex).sort()\n )\n}\n\n/**\n * Builds the index, creating an instance of lunr.Index.\n *\n * This completes the indexing process and should only be called\n * once all documents have been added to the index.\n *\n * @returns {lunr.Index}\n */\nlunr.Builder.prototype.build = function () {\n this.calculateAverageFieldLengths()\n this.createFieldVectors()\n this.createTokenSet()\n\n return new lunr.Index({\n invertedIndex: this.invertedIndex,\n fieldVectors: this.fieldVectors,\n tokenSet: this.tokenSet,\n fields: Object.keys(this._fields),\n pipeline: this.searchPipeline\n })\n}\n\n/**\n * Applies a plugin to the index builder.\n *\n * A plugin is a function that is called with the index builder as its context.\n * Plugins can be used to customise or extend the behaviour of the index\n * in some way. A plugin is just a function, that encapsulated the custom\n * behaviour that should be applied when building the index.\n *\n * The plugin function will be called with the index builder as its argument, additional\n * arguments can also be passed when calling use. The function will be called\n * with the index builder as its context.\n *\n * @param {Function} plugin The plugin to apply.\n */\nlunr.Builder.prototype.use = function (fn) {\n var args = Array.prototype.slice.call(arguments, 1)\n args.unshift(this)\n fn.apply(this, args)\n}\n/**\n * Contains and collects metadata about a matching document.\n * A single instance of lunr.MatchData is returned as part of every\n * lunr.Index~Result.\n *\n * @constructor\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n * @property {object} metadata - A cloned collection of metadata associated with this document.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData = function (term, field, metadata) {\n var clonedMetadata = Object.create(null),\n metadataKeys = Object.keys(metadata || {})\n\n // Cloning the metadata to prevent the original\n // being mutated during match data combination.\n // Metadata is kept in an array within the inverted\n // index so cloning the data can be done with\n // Array#slice\n for (var i = 0; i < metadataKeys.length; i++) {\n var key = metadataKeys[i]\n clonedMetadata[key] = metadata[key].slice()\n }\n\n this.metadata = Object.create(null)\n\n if (term !== undefined) {\n this.metadata[term] = Object.create(null)\n this.metadata[term][field] = clonedMetadata\n }\n}\n\n/**\n * An instance of lunr.MatchData will be created for every term that matches a\n * document. However only one instance is required in a lunr.Index~Result. This\n * method combines metadata from another instance of lunr.MatchData with this\n * objects metadata.\n *\n * @param {lunr.MatchData} otherMatchData - Another instance of match data to merge with this one.\n * @see {@link lunr.Index~Result}\n */\nlunr.MatchData.prototype.combine = function (otherMatchData) {\n var terms = Object.keys(otherMatchData.metadata)\n\n for (var i = 0; i < terms.length; i++) {\n var term = terms[i],\n fields = Object.keys(otherMatchData.metadata[term])\n\n if (this.metadata[term] == undefined) {\n this.metadata[term] = Object.create(null)\n }\n\n for (var j = 0; j < fields.length; j++) {\n var field = fields[j],\n keys = Object.keys(otherMatchData.metadata[term][field])\n\n if (this.metadata[term][field] == undefined) {\n this.metadata[term][field] = Object.create(null)\n }\n\n for (var k = 0; k < keys.length; k++) {\n var key = keys[k]\n\n if (this.metadata[term][field][key] == undefined) {\n this.metadata[term][field][key] = otherMatchData.metadata[term][field][key]\n } else {\n this.metadata[term][field][key] = this.metadata[term][field][key].concat(otherMatchData.metadata[term][field][key])\n }\n\n }\n }\n }\n}\n\n/**\n * Add metadata for a term/field pair to this instance of match data.\n *\n * @param {string} term - The term this match data is associated with\n * @param {string} field - The field in which the term was found\n * @param {object} metadata - The metadata recorded about this term in this field\n */\nlunr.MatchData.prototype.add = function (term, field, metadata) {\n if (!(term in this.metadata)) {\n this.metadata[term] = Object.create(null)\n this.metadata[term][field] = metadata\n return\n }\n\n if (!(field in this.metadata[term])) {\n this.metadata[term][field] = metadata\n return\n }\n\n var metadataKeys = Object.keys(metadata)\n\n for (var i = 0; i < metadataKeys.length; i++) {\n var key = metadataKeys[i]\n\n if (key in this.metadata[term][field]) {\n this.metadata[term][field][key] = this.metadata[term][field][key].concat(metadata[key])\n } else {\n this.metadata[term][field][key] = metadata[key]\n }\n }\n}\n/**\n * A lunr.Query provides a programmatic way of defining queries to be performed\n * against a {@link lunr.Index}.\n *\n * Prefer constructing a lunr.Query using the {@link lunr.Index#query} method\n * so the query object is pre-initialized with the right index fields.\n *\n * @constructor\n * @property {lunr.Query~Clause[]} clauses - An array of query clauses.\n * @property {string[]} allFields - An array of all available fields in a lunr.Index.\n */\nlunr.Query = function (allFields) {\n this.clauses = []\n this.allFields = allFields\n}\n\n/**\n * Constants for indicating what kind of automatic wildcard insertion will be used when constructing a query clause.\n *\n * This allows wildcards to be added to the beginning and end of a term without having to manually do any string\n * concatenation.\n *\n * The wildcard constants can be bitwise combined to select both leading and trailing wildcards.\n *\n * @constant\n * @default\n * @property {number} wildcard.NONE - The term will have no wildcards inserted, this is the default behaviour\n * @property {number} wildcard.LEADING - Prepend the term with a wildcard, unless a leading wildcard already exists\n * @property {number} wildcard.TRAILING - Append a wildcard to the term, unless a trailing wildcard already exists\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example query term with trailing wildcard\n * query.term('foo', { wildcard: lunr.Query.wildcard.TRAILING })\n * @example query term with leading and trailing wildcard\n * query.term('foo', {\n * wildcard: lunr.Query.wildcard.LEADING | lunr.Query.wildcard.TRAILING\n * })\n */\n\nlunr.Query.wildcard = new String (\"*\")\nlunr.Query.wildcard.NONE = 0\nlunr.Query.wildcard.LEADING = 1\nlunr.Query.wildcard.TRAILING = 2\n\n/**\n * Constants for indicating what kind of presence a term must have in matching documents.\n *\n * @constant\n * @enum {number}\n * @see lunr.Query~Clause\n * @see lunr.Query#clause\n * @see lunr.Query#term\n * @example query term with required presence\n * query.term('foo', { presence: lunr.Query.presence.REQUIRED })\n */\nlunr.Query.presence = {\n /**\n * Term's presence in a document is optional, this is the default value.\n */\n OPTIONAL: 1,\n\n /**\n * Term's presence in a document is required, documents that do not contain\n * this term will not be returned.\n */\n REQUIRED: 2,\n\n /**\n * Term's presence in a document is prohibited, documents that do contain\n * this term will not be returned.\n */\n PROHIBITED: 3\n}\n\n/**\n * A single clause in a {@link lunr.Query} contains a term and details on how to\n * match that term against a {@link lunr.Index}.\n *\n * @typedef {Object} lunr.Query~Clause\n * @property {string[]} fields - The fields in an index this clause should be matched against.\n * @property {number} [boost=1] - Any boost that should be applied when matching this clause.\n * @property {number} [editDistance] - Whether the term should have fuzzy matching applied, and how fuzzy the match should be.\n * @property {boolean} [usePipeline] - Whether the term should be passed through the search pipeline.\n * @property {number} [wildcard=lunr.Query.wildcard.NONE] - Whether the term should have wildcards appended or prepended.\n * @property {number} [presence=lunr.Query.presence.OPTIONAL] - The terms presence in any matching documents.\n */\n\n/**\n * Adds a {@link lunr.Query~Clause} to this query.\n *\n * Unless the clause contains the fields to be matched all fields will be matched. In addition\n * a default boost of 1 is applied to the clause.\n *\n * @param {lunr.Query~Clause} clause - The clause to add to this query.\n * @see lunr.Query~Clause\n * @returns {lunr.Query}\n */\nlunr.Query.prototype.clause = function (clause) {\n if (!('fields' in clause)) {\n clause.fields = this.allFields\n }\n\n if (!('boost' in clause)) {\n clause.boost = 1\n }\n\n if (!('usePipeline' in clause)) {\n clause.usePipeline = true\n }\n\n if (!('wildcard' in clause)) {\n clause.wildcard = lunr.Query.wildcard.NONE\n }\n\n if ((clause.wildcard & lunr.Query.wildcard.LEADING) && (clause.term.charAt(0) != lunr.Query.wildcard)) {\n clause.term = \"*\" + clause.term\n }\n\n if ((clause.wildcard & lunr.Query.wildcard.TRAILING) && (clause.term.slice(-1) != lunr.Query.wildcard)) {\n clause.term = \"\" + clause.term + \"*\"\n }\n\n if (!('presence' in clause)) {\n clause.presence = lunr.Query.presence.OPTIONAL\n }\n\n this.clauses.push(clause)\n\n return this\n}\n\n/**\n * A negated query is one in which every clause has a presence of\n * prohibited. These queries require some special processing to return\n * the expected results.\n *\n * @returns boolean\n */\nlunr.Query.prototype.isNegated = function () {\n for (var i = 0; i < this.clauses.length; i++) {\n if (this.clauses[i].presence != lunr.Query.presence.PROHIBITED) {\n return false\n }\n }\n\n return true\n}\n\n/**\n * Adds a term to the current query, under the covers this will create a {@link lunr.Query~Clause}\n * to the list of clauses that make up this query.\n *\n * The term is used as is, i.e. no tokenization will be performed by this method. Instead conversion\n * to a token or token-like string should be done before calling this method.\n *\n * The term will be converted to a string by calling `toString`. Multiple terms can be passed as an\n * array, each term in the array will share the same options.\n *\n * @param {object|object[]} term - The term(s) to add to the query.\n * @param {object} [options] - Any additional properties to add to the query clause.\n * @returns {lunr.Query}\n * @see lunr.Query#clause\n * @see lunr.Query~Clause\n * @example adding a single term to a query\n * query.term(\"foo\")\n * @example adding a single term to a query and specifying search fields, term boost and automatic trailing wildcard\n * query.term(\"foo\", {\n * fields: [\"title\"],\n * boost: 10,\n * wildcard: lunr.Query.wildcard.TRAILING\n * })\n * @example using lunr.tokenizer to convert a string to tokens before using them as terms\n * query.term(lunr.tokenizer(\"foo bar\"))\n */\nlunr.Query.prototype.term = function (term, options) {\n if (Array.isArray(term)) {\n term.forEach(function (t) { this.term(t, lunr.utils.clone(options)) }, this)\n return this\n }\n\n var clause = options || {}\n clause.term = term.toString()\n\n this.clause(clause)\n\n return this\n}\nlunr.QueryParseError = function (message, start, end) {\n this.name = \"QueryParseError\"\n this.message = message\n this.start = start\n this.end = end\n}\n\nlunr.QueryParseError.prototype = new Error\nlunr.QueryLexer = function (str) {\n this.lexemes = []\n this.str = str\n this.length = str.length\n this.pos = 0\n this.start = 0\n this.escapeCharPositions = []\n}\n\nlunr.QueryLexer.prototype.run = function () {\n var state = lunr.QueryLexer.lexText\n\n while (state) {\n state = state(this)\n }\n}\n\nlunr.QueryLexer.prototype.sliceString = function () {\n var subSlices = [],\n sliceStart = this.start,\n sliceEnd = this.pos\n\n for (var i = 0; i < this.escapeCharPositions.length; i++) {\n sliceEnd = this.escapeCharPositions[i]\n subSlices.push(this.str.slice(sliceStart, sliceEnd))\n sliceStart = sliceEnd + 1\n }\n\n subSlices.push(this.str.slice(sliceStart, this.pos))\n this.escapeCharPositions.length = 0\n\n return subSlices.join('')\n}\n\nlunr.QueryLexer.prototype.emit = function (type) {\n this.lexemes.push({\n type: type,\n str: this.sliceString(),\n start: this.start,\n end: this.pos\n })\n\n this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.escapeCharacter = function () {\n this.escapeCharPositions.push(this.pos - 1)\n this.pos += 1\n}\n\nlunr.QueryLexer.prototype.next = function () {\n if (this.pos >= this.length) {\n return lunr.QueryLexer.EOS\n }\n\n var char = this.str.charAt(this.pos)\n this.pos += 1\n return char\n}\n\nlunr.QueryLexer.prototype.width = function () {\n return this.pos - this.start\n}\n\nlunr.QueryLexer.prototype.ignore = function () {\n if (this.start == this.pos) {\n this.pos += 1\n }\n\n this.start = this.pos\n}\n\nlunr.QueryLexer.prototype.backup = function () {\n this.pos -= 1\n}\n\nlunr.QueryLexer.prototype.acceptDigitRun = function () {\n var char, charCode\n\n do {\n char = this.next()\n charCode = char.charCodeAt(0)\n } while (charCode > 47 && charCode < 58)\n\n if (char != lunr.QueryLexer.EOS) {\n this.backup()\n }\n}\n\nlunr.QueryLexer.prototype.more = function () {\n return this.pos < this.length\n}\n\nlunr.QueryLexer.EOS = 'EOS'\nlunr.QueryLexer.FIELD = 'FIELD'\nlunr.QueryLexer.TERM = 'TERM'\nlunr.QueryLexer.EDIT_DISTANCE = 'EDIT_DISTANCE'\nlunr.QueryLexer.BOOST = 'BOOST'\nlunr.QueryLexer.PRESENCE = 'PRESENCE'\n\nlunr.QueryLexer.lexField = function (lexer) {\n lexer.backup()\n lexer.emit(lunr.QueryLexer.FIELD)\n lexer.ignore()\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexTerm = function (lexer) {\n if (lexer.width() > 1) {\n lexer.backup()\n lexer.emit(lunr.QueryLexer.TERM)\n }\n\n lexer.ignore()\n\n if (lexer.more()) {\n return lunr.QueryLexer.lexText\n }\n}\n\nlunr.QueryLexer.lexEditDistance = function (lexer) {\n lexer.ignore()\n lexer.acceptDigitRun()\n lexer.emit(lunr.QueryLexer.EDIT_DISTANCE)\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexBoost = function (lexer) {\n lexer.ignore()\n lexer.acceptDigitRun()\n lexer.emit(lunr.QueryLexer.BOOST)\n return lunr.QueryLexer.lexText\n}\n\nlunr.QueryLexer.lexEOS = function (lexer) {\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n}\n\n// This matches the separator used when tokenising fields\n// within a document. These should match otherwise it is\n// not possible to search for some tokens within a document.\n//\n// It is possible for the user to change the separator on the\n// tokenizer so it _might_ clash with any other of the special\n// characters already used within the search string, e.g. :.\n//\n// This means that it is possible to change the separator in\n// such a way that makes some words unsearchable using a search\n// string.\nlunr.QueryLexer.termSeparator = lunr.tokenizer.separator\n\nlunr.QueryLexer.lexText = function (lexer) {\n while (true) {\n var char = lexer.next()\n\n if (char == lunr.QueryLexer.EOS) {\n return lunr.QueryLexer.lexEOS\n }\n\n // Escape character is '\\'\n if (char.charCodeAt(0) == 92) {\n lexer.escapeCharacter()\n continue\n }\n\n if (char == \":\") {\n return lunr.QueryLexer.lexField\n }\n\n if (char == \"~\") {\n lexer.backup()\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n return lunr.QueryLexer.lexEditDistance\n }\n\n if (char == \"^\") {\n lexer.backup()\n if (lexer.width() > 0) {\n lexer.emit(lunr.QueryLexer.TERM)\n }\n return lunr.QueryLexer.lexBoost\n }\n\n // \"+\" indicates term presence is required\n // checking for length to ensure that only\n // leading \"+\" are considered\n if (char == \"+\" && lexer.width() === 1) {\n lexer.emit(lunr.QueryLexer.PRESENCE)\n return lunr.QueryLexer.lexText\n }\n\n // \"-\" indicates term presence is prohibited\n // checking for length to ensure that only\n // leading \"-\" are considered\n if (char == \"-\" && lexer.width() === 1) {\n lexer.emit(lunr.QueryLexer.PRESENCE)\n return lunr.QueryLexer.lexText\n }\n\n if (char.match(lunr.QueryLexer.termSeparator)) {\n return lunr.QueryLexer.lexTerm\n }\n }\n}\n\nlunr.QueryParser = function (str, query) {\n this.lexer = new lunr.QueryLexer (str)\n this.query = query\n this.currentClause = {}\n this.lexemeIdx = 0\n}\n\nlunr.QueryParser.prototype.parse = function () {\n this.lexer.run()\n this.lexemes = this.lexer.lexemes\n\n var state = lunr.QueryParser.parseClause\n\n while (state) {\n state = state(this)\n }\n\n return this.query\n}\n\nlunr.QueryParser.prototype.peekLexeme = function () {\n return this.lexemes[this.lexemeIdx]\n}\n\nlunr.QueryParser.prototype.consumeLexeme = function () {\n var lexeme = this.peekLexeme()\n this.lexemeIdx += 1\n return lexeme\n}\n\nlunr.QueryParser.prototype.nextClause = function () {\n var completedClause = this.currentClause\n this.query.clause(completedClause)\n this.currentClause = {}\n}\n\nlunr.QueryParser.parseClause = function (parser) {\n var lexeme = parser.peekLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n switch (lexeme.type) {\n case lunr.QueryLexer.PRESENCE:\n return lunr.QueryParser.parsePresence\n case lunr.QueryLexer.FIELD:\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expected either a field or a term, found \" + lexeme.type\n\n if (lexeme.str.length >= 1) {\n errorMessage += \" with value '\" + lexeme.str + \"'\"\n }\n\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n}\n\nlunr.QueryParser.parsePresence = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n switch (lexeme.str) {\n case \"-\":\n parser.currentClause.presence = lunr.Query.presence.PROHIBITED\n break\n case \"+\":\n parser.currentClause.presence = lunr.Query.presence.REQUIRED\n break\n default:\n var errorMessage = \"unrecognised presence operator'\" + lexeme.str + \"'\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n var errorMessage = \"expecting term or field, found nothing\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.FIELD:\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expecting term or field, found '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseField = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n if (parser.query.allFields.indexOf(lexeme.str) == -1) {\n var possibleFields = parser.query.allFields.map(function (f) { return \"'\" + f + \"'\" }).join(', '),\n errorMessage = \"unrecognised field '\" + lexeme.str + \"', possible fields: \" + possibleFields\n\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.fields = [lexeme.str]\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n var errorMessage = \"expecting term, found nothing\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n return lunr.QueryParser.parseTerm\n default:\n var errorMessage = \"expecting term, found '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseTerm = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n parser.currentClause.term = lexeme.str.toLowerCase()\n\n if (lexeme.str.indexOf(\"*\") != -1) {\n parser.currentClause.usePipeline = false\n }\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseEditDistance = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n var editDistance = parseInt(lexeme.str, 10)\n\n if (isNaN(editDistance)) {\n var errorMessage = \"edit distance must be numeric\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.editDistance = editDistance\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\nlunr.QueryParser.parseBoost = function (parser) {\n var lexeme = parser.consumeLexeme()\n\n if (lexeme == undefined) {\n return\n }\n\n var boost = parseInt(lexeme.str, 10)\n\n if (isNaN(boost)) {\n var errorMessage = \"boost must be numeric\"\n throw new lunr.QueryParseError (errorMessage, lexeme.start, lexeme.end)\n }\n\n parser.currentClause.boost = boost\n\n var nextLexeme = parser.peekLexeme()\n\n if (nextLexeme == undefined) {\n parser.nextClause()\n return\n }\n\n switch (nextLexeme.type) {\n case lunr.QueryLexer.TERM:\n parser.nextClause()\n return lunr.QueryParser.parseTerm\n case lunr.QueryLexer.FIELD:\n parser.nextClause()\n return lunr.QueryParser.parseField\n case lunr.QueryLexer.EDIT_DISTANCE:\n return lunr.QueryParser.parseEditDistance\n case lunr.QueryLexer.BOOST:\n return lunr.QueryParser.parseBoost\n case lunr.QueryLexer.PRESENCE:\n parser.nextClause()\n return lunr.QueryParser.parsePresence\n default:\n var errorMessage = \"Unexpected lexeme type '\" + nextLexeme.type + \"'\"\n throw new lunr.QueryParseError (errorMessage, nextLexeme.start, nextLexeme.end)\n }\n}\n\n /**\n * export the module via AMD, CommonJS or as a browser global\n * Export code from https://github.com/umdjs/umd/blob/master/returnExports.js\n */\n ;(function (root, factory) {\n if (typeof define === 'function' && define.amd) {\n // AMD. Register as an anonymous module.\n define(factory)\n } else if (typeof exports === 'object') {\n /**\n * Node. Does not work with strict CommonJS, but\n * only CommonJS-like enviroments that support module.exports,\n * like Node.\n */\n module.exports = factory()\n } else {\n // Browser globals (root is window)\n root.lunr = factory()\n }\n }(this, function () {\n /**\n * Just return a value to define the module export.\n * This example returns an object, but the module\n * can return a function as the exported value.\n */\n return lunr\n }))\n})();\n", "/*!\n * escape-html\n * Copyright(c) 2012-2013 TJ Holowaychuk\n * Copyright(c) 2015 Andreas Lubbe\n * Copyright(c) 2015 Tiancheng \"Timothy\" Gu\n * MIT Licensed\n */\n\n'use strict';\n\n/**\n * Module variables.\n * @private\n */\n\nvar matchHtmlRegExp = /[\"'&<>]/;\n\n/**\n * Module exports.\n * @public\n */\n\nmodule.exports = escapeHtml;\n\n/**\n * Escape special characters in the given string of html.\n *\n * @param {string} string The string to escape for inserting into HTML\n * @return {string}\n * @public\n */\n\nfunction escapeHtml(string) {\n var str = '' + string;\n var match = matchHtmlRegExp.exec(str);\n\n if (!match) {\n return str;\n }\n\n var escape;\n var html = '';\n var index = 0;\n var lastIndex = 0;\n\n for (index = match.index; index < str.length; index++) {\n switch (str.charCodeAt(index)) {\n case 34: // \"\n escape = '"';\n break;\n case 38: // &\n escape = '&';\n break;\n case 39: // '\n escape = ''';\n break;\n case 60: // <\n escape = '<';\n break;\n case 62: // >\n escape = '>';\n break;\n default:\n continue;\n }\n\n if (lastIndex !== index) {\n html += str.substring(lastIndex, index);\n }\n\n lastIndex = index + 1;\n html += escape;\n }\n\n return lastIndex !== index\n ? html + str.substring(lastIndex, index)\n : html;\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A RTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport lunr from \"lunr\"\n\nimport \"~/polyfills\"\n\nimport { Search, SearchIndexConfig } from \"../../_\"\nimport {\n SearchMessage,\n SearchMessageType\n} from \"../message\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Add support for usage with `iframe-worker` polyfill\n *\n * While `importScripts` is synchronous when executed inside of a web worker,\n * it's not possible to provide a synchronous polyfilled implementation. The\n * cool thing is that awaiting a non-Promise is a noop, so extending the type\n * definition to return a `Promise` shouldn't break anything.\n *\n * @see https://bit.ly/2PjDnXi - GitHub comment\n */\ndeclare global {\n function importScripts(...urls: string[]): Promise | void\n}\n\n/* ----------------------------------------------------------------------------\n * Data\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nlet index: Search\n\n/* ----------------------------------------------------------------------------\n * Helper functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Fetch (= import) multi-language support through `lunr-languages`\n *\n * This function automatically imports the stemmers necessary to process the\n * languages, which are defined through the search index configuration.\n *\n * If the worker runs inside of an `iframe` (when using `iframe-worker` as\n * a shim), the base URL for the stemmers to be loaded must be determined by\n * searching for the first `script` element with a `src` attribute, which will\n * contain the contents of this script.\n *\n * @param config - Search index configuration\n *\n * @returns Promise resolving with no result\n */\nasync function setupSearchLanguages(\n config: SearchIndexConfig\n): Promise {\n let base = \"../lunr\"\n\n /* Detect `iframe-worker` and fix base URL */\n if (typeof parent !== \"undefined\" && \"IFrameWorker\" in parent) {\n const worker = document.querySelector(\"script[src]\")!\n const [path] = worker.src.split(\"/worker\")\n\n /* Prefix base with path */\n base = base.replace(\"..\", path)\n }\n\n /* Add scripts for languages */\n const scripts = []\n for (const lang of config.lang) {\n switch (lang) {\n\n /* Add segmenter for Japanese */\n case \"ja\":\n scripts.push(`${base}/tinyseg.js`)\n break\n\n /* Add segmenter for Hindi and Thai */\n case \"hi\":\n case \"th\":\n scripts.push(`${base}/wordcut.js`)\n break\n }\n\n /* Add language support */\n if (lang !== \"en\")\n scripts.push(`${base}/min/lunr.${lang}.min.js`)\n }\n\n /* Add multi-language support */\n if (config.lang.length > 1)\n scripts.push(`${base}/min/lunr.multi.min.js`)\n\n /* Load scripts synchronously */\n if (scripts.length)\n await importScripts(\n `${base}/min/lunr.stemmer.support.min.js`,\n ...scripts\n )\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Message handler\n *\n * @param message - Source message\n *\n * @returns Target message\n */\nexport async function handler(\n message: SearchMessage\n): Promise {\n switch (message.type) {\n\n /* Search setup message */\n case SearchMessageType.SETUP:\n await setupSearchLanguages(message.data.config)\n index = new Search(message.data)\n return {\n type: SearchMessageType.READY\n }\n\n /* Search query message */\n case SearchMessageType.QUERY:\n return {\n type: SearchMessageType.RESULT,\n data: index ? index.search(message.data) : { items: [] }\n }\n\n /* All other messages */\n default:\n throw new TypeError(\"Invalid message type\")\n }\n}\n\n/* ----------------------------------------------------------------------------\n * Worker\n * ------------------------------------------------------------------------- */\n\n/* @ts-expect-error - expose Lunr.js in global scope, or stemmers won't work */\nself.lunr = lunr\n\n/* Handle messages */\naddEventListener(\"message\", async ev => {\n postMessage(await handler(ev.data))\n})\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Polyfills\n * ------------------------------------------------------------------------- */\n\n/* Polyfill `Object.entries` */\nif (!Object.entries)\n Object.entries = function (obj: object) {\n const data: [string, string][] = []\n for (const key of Object.keys(obj))\n // @ts-expect-error - ignore property access warning\n data.push([key, obj[key]])\n\n /* Return entries */\n return data\n }\n\n/* Polyfill `Object.values` */\nif (!Object.values)\n Object.values = function (obj: object) {\n const data: string[] = []\n for (const key of Object.keys(obj))\n // @ts-expect-error - ignore property access warning\n data.push(obj[key])\n\n /* Return values */\n return data\n }\n\n/* ------------------------------------------------------------------------- */\n\n/* Polyfills for `Element` */\nif (typeof Element !== \"undefined\") {\n\n /* Polyfill `Element.scrollTo` */\n if (!Element.prototype.scrollTo)\n Element.prototype.scrollTo = function (\n x?: ScrollToOptions | number, y?: number\n ): void {\n if (typeof x === \"object\") {\n this.scrollLeft = x.left!\n this.scrollTop = x.top!\n } else {\n this.scrollLeft = x!\n this.scrollTop = y!\n }\n }\n\n /* Polyfill `Element.replaceWith` */\n if (!Element.prototype.replaceWith)\n Element.prototype.replaceWith = function (\n ...nodes: Array\n ): void {\n const parent = this.parentNode\n if (parent) {\n if (nodes.length === 0)\n parent.removeChild(this)\n\n /* Replace children and create text nodes */\n for (let i = nodes.length - 1; i >= 0; i--) {\n let node = nodes[i]\n if (typeof node !== \"object\")\n node = document.createTextNode(node)\n else if (node.parentNode)\n node.parentNode.removeChild(node)\n\n /* Replace child or insert before previous sibling */\n if (!i)\n parent.replaceChild(node, this)\n else\n parent.insertBefore(this.previousSibling!, node)\n }\n }\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexDocument } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search document\n */\nexport interface SearchDocument extends SearchIndexDocument {\n parent?: SearchIndexDocument /* Parent article */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search document mapping\n */\nexport type SearchDocumentMap = Map\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search document mapping\n *\n * @param docs - Search index documents\n *\n * @returns Search document map\n */\nexport function setupSearchDocumentMap(\n docs: SearchIndexDocument[]\n): SearchDocumentMap {\n const documents = new Map()\n const parents = new Set()\n for (const doc of docs) {\n const [path, hash] = doc.location.split(\"#\")\n\n /* Extract location, title and tags */\n const location = doc.location\n const title = doc.title\n const tags = doc.tags\n\n /* Escape and cleanup text */\n const text = escapeHTML(doc.text)\n .replace(/\\s+(?=[,.:;!?])/g, \"\")\n .replace(/\\s+/g, \" \")\n\n /* Handle section */\n if (hash) {\n const parent = documents.get(path)!\n\n /* Ignore first section, override article */\n if (!parents.has(parent)) {\n parent.title = doc.title\n parent.text = text\n\n /* Remember that we processed the article */\n parents.add(parent)\n\n /* Add subsequent section */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n parent\n })\n }\n\n /* Add article */\n } else {\n documents.set(location, {\n location,\n title,\n text,\n ...tags && { tags }\n })\n }\n }\n return documents\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport escapeHTML from \"escape-html\"\n\nimport { SearchIndexConfig } from \"../_\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search highlight function\n *\n * @param value - Value\n *\n * @returns Highlighted value\n */\nexport type SearchHighlightFn = (value: string) => string\n\n/**\n * Search highlight factory function\n *\n * @param query - Query value\n *\n * @returns Search highlight function\n */\nexport type SearchHighlightFactoryFn = (query: string) => SearchHighlightFn\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Create a search highlighter\n *\n * @param config - Search index configuration\n * @param escape - Whether to escape HTML\n *\n * @returns Search highlight factory function\n */\nexport function setupSearchHighlighter(\n config: SearchIndexConfig, escape: boolean\n): SearchHighlightFactoryFn {\n const separator = new RegExp(config.separator, \"img\")\n const highlight = (_: unknown, data: string, term: string) => {\n return `${data}${term}`\n }\n\n /* Return factory function */\n return (query: string) => {\n query = query\n .replace(/[\\s*+\\-:~^]+/g, \" \")\n .trim()\n\n /* Create search term match expression */\n const match = new RegExp(`(^|${config.separator})(${\n query\n .replace(/[|\\\\{}()[\\]^$+*?.-]/g, \"\\\\$&\")\n .replace(separator, \"|\")\n })`, \"img\")\n\n /* Highlight string value */\n return value => (\n escape\n ? escapeHTML(value)\n : value\n )\n .replace(match, highlight)\n .replace(/<\\/mark>(\\s+)]*>/img, \"$1\")\n }\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search query clause\n */\nexport interface SearchQueryClause {\n presence: lunr.Query.presence /* Clause presence */\n term: string /* Clause term */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search query terms\n */\nexport type SearchQueryTerms = Record\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Parse a search query for analysis\n *\n * @param value - Query value\n *\n * @returns Search query clauses\n */\nexport function parseSearchQuery(\n value: string\n): SearchQueryClause[] {\n const query = new (lunr as any).Query([\"title\", \"text\"])\n const parser = new (lunr as any).QueryParser(value, query)\n\n /* Parse and return query clauses */\n parser.parse()\n return query.clauses\n}\n\n/**\n * Analyze the search query clauses in regard to the search terms found\n *\n * @param query - Search query clauses\n * @param terms - Search terms\n *\n * @returns Search query terms\n */\nexport function getSearchQueryTerms(\n query: SearchQueryClause[], terms: string[]\n): SearchQueryTerms {\n const clauses = new Set(query)\n\n /* Match query clauses against terms */\n const result: SearchQueryTerms = {}\n for (let t = 0; t < terms.length; t++)\n for (const clause of clauses)\n if (terms[t].startsWith(clause.term)) {\n result[clause.term] = true\n clauses.delete(clause)\n }\n\n /* Annotate unmatched non-stopword query clauses */\n for (const clause of clauses)\n if (lunr.stopWordFilter?.(clause.term as any))\n result[clause.term] = false\n\n /* Return query terms */\n return result\n}\n", "/*\n * Copyright (c) 2016-2022 Martin Donath \n *\n * Permission is hereby granted, free of charge, to any person obtaining a copy\n * of this software and associated documentation files (the \"Software\"), to\n * deal in the Software without restriction, including without limitation the\n * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or\n * sell copies of the Software, and to permit persons to whom the Software is\n * furnished to do so, subject to the following conditions:\n *\n * The above copyright notice and this permission notice shall be included in\n * all copies or substantial portions of the Software.\n *\n * THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE\n * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING\n * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS\n * IN THE SOFTWARE.\n */\n\nimport {\n SearchDocument,\n SearchDocumentMap,\n setupSearchDocumentMap\n} from \"../document\"\nimport {\n SearchHighlightFactoryFn,\n setupSearchHighlighter\n} from \"../highlighter\"\nimport { SearchOptions } from \"../options\"\nimport {\n SearchQueryTerms,\n getSearchQueryTerms,\n parseSearchQuery\n} from \"../query\"\n\n/* ----------------------------------------------------------------------------\n * Types\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index configuration\n */\nexport interface SearchIndexConfig {\n lang: string[] /* Search languages */\n separator: string /* Search separator */\n}\n\n/**\n * Search index document\n */\nexport interface SearchIndexDocument {\n location: string /* Document location */\n title: string /* Document title */\n text: string /* Document text */\n tags?: string[] /* Document tags */\n boost?: number /* Document boost */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search index\n *\n * This interfaces describes the format of the `search_index.json` file which\n * is automatically built by the MkDocs search plugin.\n */\nexport interface SearchIndex {\n config: SearchIndexConfig /* Search index configuration */\n docs: SearchIndexDocument[] /* Search index documents */\n options: SearchOptions /* Search options */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search metadata\n */\nexport interface SearchMetadata {\n score: number /* Score (relevance) */\n terms: SearchQueryTerms /* Search query terms */\n}\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search result document\n */\nexport type SearchResultDocument = SearchDocument & SearchMetadata\n\n/**\n * Search result item\n */\nexport type SearchResultItem = SearchResultDocument[]\n\n/* ------------------------------------------------------------------------- */\n\n/**\n * Search result\n */\nexport interface SearchResult {\n items: SearchResultItem[] /* Search result items */\n suggestions?: string[] /* Search suggestions */\n}\n\n/* ----------------------------------------------------------------------------\n * Functions\n * ------------------------------------------------------------------------- */\n\n/**\n * Compute the difference of two lists of strings\n *\n * @param a - 1st list of strings\n * @param b - 2nd list of strings\n *\n * @returns Difference\n */\nfunction difference(a: string[], b: string[]): string[] {\n const [x, y] = [new Set(a), new Set(b)]\n return [\n ...new Set([...x].filter(value => !y.has(value)))\n ]\n}\n\n/* ----------------------------------------------------------------------------\n * Class\n * ------------------------------------------------------------------------- */\n\n/**\n * Search index\n */\nexport class Search {\n\n /**\n * Search document mapping\n *\n * A mapping of URLs (including hash fragments) to the actual articles and\n * sections of the documentation. The search document mapping must be created\n * regardless of whether the index was prebuilt or not, as Lunr.js itself\n * only stores the actual index.\n */\n protected documents: SearchDocumentMap\n\n /**\n * Search highlight factory function\n */\n protected highlight: SearchHighlightFactoryFn\n\n /**\n * The underlying Lunr.js search index\n */\n protected index: lunr.Index\n\n /**\n * Search options\n */\n protected options: SearchOptions\n\n /**\n * Create the search integration\n *\n * @param data - Search index\n */\n public constructor({ config, docs, options }: SearchIndex) {\n this.options = options\n\n /* Set up document map and highlighter factory */\n this.documents = setupSearchDocumentMap(docs)\n this.highlight = setupSearchHighlighter(config, false)\n\n /* Set separator for tokenizer */\n lunr.tokenizer.separator = new RegExp(config.separator)\n\n /* Create search index */\n this.index = lunr(function () {\n\n /* Set up multi-language support */\n if (config.lang.length === 1 && config.lang[0] !== \"en\") {\n this.use((lunr as any)[config.lang[0]])\n } else if (config.lang.length > 1) {\n this.use((lunr as any).multiLanguage(...config.lang))\n }\n\n /* Compute functions to be removed from the pipeline */\n const fns = difference([\n \"trimmer\", \"stopWordFilter\", \"stemmer\"\n ], options.pipeline)\n\n /* Remove functions from the pipeline for registered languages */\n for (const lang of config.lang.map(language => (\n language === \"en\" ? lunr : (lunr as any)[language]\n ))) {\n for (const fn of fns) {\n this.pipeline.remove(lang[fn])\n this.searchPipeline.remove(lang[fn])\n }\n }\n\n /* Set up reference */\n this.ref(\"location\")\n\n /* Set up fields */\n this.field(\"title\", { boost: 1e3 })\n this.field(\"text\")\n this.field(\"tags\", { boost: 1e6, extractor: doc => {\n const { tags = [] } = doc as SearchDocument\n return tags.reduce((list, tag) => [\n ...list,\n ...lunr.tokenizer(tag)\n ], [] as lunr.Token[])\n } })\n\n /* Index documents */\n for (const doc of docs)\n this.add(doc, { boost: doc.boost })\n })\n }\n\n /**\n * Search for matching documents\n *\n * The search index which MkDocs provides is divided up into articles, which\n * contain the whole content of the individual pages, and sections, which only\n * contain the contents of the subsections obtained by breaking the individual\n * pages up at `h1` ... `h6`. As there may be many sections on different pages\n * with identical titles (for example within this very project, e.g. \"Usage\"\n * or \"Installation\"), they need to be put into the context of the containing\n * page. For this reason, section results are grouped within their respective\n * articles which are the top-level results that are returned.\n *\n * @param query - Query value\n *\n * @returns Search results\n */\n public search(query: string): SearchResult {\n if (query) {\n try {\n const highlight = this.highlight(query)\n\n /* Parse query to extract clauses for analysis */\n const clauses = parseSearchQuery(query)\n .filter(clause => (\n clause.presence !== lunr.Query.presence.PROHIBITED\n ))\n\n /* Perform search and post-process results */\n const groups = this.index.search(`${query}*`)\n\n /* Apply post-query boosts based on title and search query terms */\n .reduce((item, { ref, score, matchData }) => {\n const document = this.documents.get(ref)\n if (typeof document !== \"undefined\") {\n const { location, title, text, tags, parent } = document\n\n /* Compute and analyze search query terms */\n const terms = getSearchQueryTerms(\n clauses,\n Object.keys(matchData.metadata)\n )\n\n /* Highlight title and text and apply post-query boosts */\n const boost = +!parent + +Object.values(terms).every(t => t)\n item.push({\n location,\n title: highlight(title),\n text: highlight(text),\n ...tags && { tags: tags.map(highlight) },\n score: score * (1 + boost),\n terms\n })\n }\n return item\n }, [])\n\n /* Sort search results again after applying boosts */\n .sort((a, b) => b.score - a.score)\n\n /* Group search results by page */\n .reduce((items, result) => {\n const document = this.documents.get(result.location)\n if (typeof document !== \"undefined\") {\n const ref = \"parent\" in document\n ? document.parent!.location\n : document.location\n items.set(ref, [...items.get(ref) || [], result])\n }\n return items\n }, new Map())\n\n /* Generate search suggestions, if desired */\n let suggestions: string[] | undefined\n if (this.options.suggestions) {\n const titles = this.index.query(builder => {\n for (const clause of clauses)\n builder.term(clause.term, {\n fields: [\"title\"],\n presence: lunr.Query.presence.REQUIRED,\n wildcard: lunr.Query.wildcard.TRAILING\n })\n })\n\n /* Retrieve suggestions for best match */\n suggestions = titles.length\n ? Object.keys(titles[0].matchData.metadata)\n : []\n }\n\n /* Return items and suggestions */\n return {\n items: [...groups.values()],\n ...typeof suggestions !== \"undefined\" && { suggestions }\n }\n\n /* Log errors to console (for now) */\n } catch {\n console.warn(`Invalid query: ${query} \u2013 see https://bit.ly/2s3ChXG`)\n }\n }\n\n /* Return nothing in case of error or empty query */\n return { items: [] }\n }\n}\n"], + "mappings": "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L,CAAI,KACrDD,EAAIC,EAER,CAEA,OAAAG,EAAKP,EACLQ,EAAMzB,EACFwB,EAAG,KAAKJ,CAAC,GAAKK,EAAI,KAAKL,CAAC,IAC1BI,EAAKjB,EACLa,EAAIA,EAAE,QAAQI,EAAG,EAAE,GAKjBD,GAAW,MACbH,EAAIG,EAAQ,YAAY,EAAIH,EAAE,OAAO,CAAC,GAGjCA,CACT,EAEA,OAAO,SAAUhD,EAAO,CACtB,OAAOA,EAAM,OAAO+C,CAAa,CACnC,CACF,EAAG,EAEHpG,EAAK,SAAS,iBAAiBA,EAAK,QAAS,SAAS,EACtD;AAAA;AAAA;AAAA,GAkBAA,EAAK,uBAAyB,SAAU8G,EAAW,CACjD,IAAIC,EAAQD,EAAU,OAAO,SAAU7D,EAAM+D,EAAU,CACrD,OAAA/D,EAAK+D,GAAYA,EACV/D,CACT,EAAG,CAAC,CAAC,EAEL,OAAO,SAAUI,EAAO,CACtB,GAAIA,GAAS0D,EAAM1D,EAAM,SAAS,KAAOA,EAAM,SAAS,EAAG,OAAOA,CACpE,CACF,EAeArD,EAAK,eAAiBA,EAAK,uBAAuB,CAChD,IACA,OACA,QACA,SACA,QACA,MACA,SACA,OACA,KACA,QACA,KACA,MACA,MACA,MACA,KACA,KACA,KACA,UACA,OACA,MACA,KACA,MACA,SACA,QACA,OACA,MACA,KACA,OACA,SACA,OACA,OACA,QACA,MACA,OACA,MACA,MACA,MACA,MACA,OACA,KACA,MACA,OACA,MACA,MACA,MACA,UACA,IACA,KACA,KACA,OACA,KACA,KACA,MACA,OACA,QACA,MACA,OACA,SACA,MACA,KACA,QACA,OACA,OACA,KACA,UACA,KACA,MACA,MACA,KACA,MACA,QACA,KACA,OACA,KACA,QACA,MACA,MACA,SACA,OACA,MACA,OACA,MACA,SACA,QACA,KACA,OACA,OACA,OACA,MACA,QACA,OACA,OACA,QACA,QACA,OACA,OACA,MACA,KACA,MACA,OACA,KACA,QACA,MACA,KACA,OACA,OACA,OACA,QACA,QACA,QACA,MACA,OACA,MACA,OACA,OACA,QACA,MACA,MACA,MACF,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", + "names": ["require_lunr", "__commonJSMin", "exports", "module", "lunr", "config", "builder", "global", "message", "obj", "clone", "keys", "key", "val", "docRef", "fieldName", "stringValue", "s", "n", "fieldRef", "elements", "i", "other", "object", "a", "b", "intersection", "element", "posting", "documentCount", "documentsWithTerm", "x", "str", "metadata", "fn", "t", "len", "tokens", "sliceEnd", "sliceStart", "char", "sliceLength", "tokenMetadata", "label", "isRegistered", "serialised", "pipeline", "fnName", "fns", "existingFn", "newFn", "pos", "stackLength", "memo", "j", "result", "k", "token", "index", "start", "end", "pivotPoint", "pivotIndex", "insertIdx", "position", "sumOfSquares", "elementsLength", "otherVector", "dotProduct", "aLen", "bLen", "aVal", "bVal", "output", "step2list", "step3list", "c", "v", "C", "V", "mgr0", "meq1", "mgr1", "s_v", "re_mgr0", "re_mgr1", "re_meq1", "re_s_v", "re_1a", "re2_1a", "re_1b", "re2_1b", "re_1b_2", "re2_1b_2", "re3_1b_2", "re4_1b_2", "re_1c", "re_2", "re_3", "re_4", "re2_4", "re_5", "re_5_1", "re3_5", "porterStemmer", "w", "stem", "suffix", "firstch", "re", "re2", "re3", "re4", "fp", "stopWords", "words", "stopWord", "arr", "clause", "editDistance", "root", "stack", "frame", "noEditNode", "insertionNode", "substitutionNode", "charA", "charB", "transposeNode", "node", "final", "next", "edges", "edge", "labels", "qEdges", "qLen", "nEdges", "nLen", "q", "qEdge", "nEdge", "qNode", "word", "commonPrefix", "nextNode", "downTo", "childKey", "attrs", "queryString", "query", "parser", "matchingFields", "queryVectors", "termFieldCache", "requiredMatches", "prohibitedMatches", "terms", "clauseMatches", "m", "term", "termTokenSet", "expandedTerms", "field", "expandedTerm", "termIndex", "fieldPosting", "matchingDocumentRefs", "termField", "matchingDocumentsSet", "l", "matchingDocumentRef", "matchingFieldRef", "fieldMatch", "allRequiredMatches", "allProhibitedMatches", "matchingFieldRefs", "results", "matches", "fieldVector", "score", "docMatch", "match", "invertedIndex", "fieldVectors", "ref", "serializedIndex", "serializedVectors", "serializedInvertedIndex", "tokenSetBuilder", "tuple", "attributes", "number", "doc", "fields", "extractor", "fieldTerms", "metadataKey", "fieldRefs", "numberOfFields", "accumulator", "documentsWithField", "fieldRefsLength", "termIdfCache", "fieldLength", "termFrequencies", "termsLength", "fieldBoost", "docBoost", "tf", "idf", "scoreWithPrecision", "args", "clonedMetadata", "metadataKeys", "otherMatchData", "allFields", "options", "state", "subSlices", "type", "charCode", "lexer", "lexeme", "completedClause", "errorMessage", "nextLexeme", "possibleFields", "f", "boost", "factory", "require_escape_html", "__commonJSMin", "exports", "module", "matchHtmlRegExp", "escapeHtml", "string", "str", "match", "escape", "html", "index", "lastIndex", "import_lunr", "obj", "data", "key", "x", "y", "nodes", "parent", "i", "node", "import_escape_html", "setupSearchDocumentMap", "docs", "documents", "parents", "doc", "path", "hash", "location", "title", "tags", "text", "escapeHTML", "parent", "__spreadValues", "import_escape_html", "setupSearchHighlighter", "config", "escape", "separator", "highlight", "_", "data", "term", "query", "match", "value", "escapeHTML", "parseSearchQuery", "value", "query", "getSearchQueryTerms", "terms", "_a", "clauses", "result", "t", "clause", "difference", "a", "b", "x", "y", "value", "Search", "config", "docs", "options", "setupSearchDocumentMap", "setupSearchHighlighter", "fns", "lang", "language", "fn", "doc", "tags", "list", "tag", "query", "highlight", "clauses", "parseSearchQuery", "clause", "groups", "item", "ref", "score", "matchData", "document", "location", "title", "text", "parent", "terms", "getSearchQueryTerms", "boost", "t", "__spreadProps", "__spreadValues", "items", "result", "suggestions", "titles", "builder", "e", "index", "setupSearchLanguages", "config", "__async", "base", "worker", "path", "scripts", "lang", "handler", "message", "Search", "lunr", "ev"] +} diff --git a/assets/stylesheets/main.80dcb947.min.css b/assets/stylesheets/main.80dcb947.min.css new file mode 100644 index 00000000..1846d835 --- /dev/null +++ b/assets/stylesheets/main.80dcb947.min.css @@ -0,0 +1 @@ +@charset "UTF-8";html{-webkit-text-size-adjust:none;-moz-text-size-adjust:none;-ms-text-size-adjust:none;text-size-adjust:none;box-sizing:border-box}*,:after,:before{box-sizing:inherit}@media (prefers-reduced-motion){*,:after,:before{transition:none!important}}body{margin:0}a,button,input,label{-webkit-tap-highlight-color:transparent}a{color:inherit;text-decoration:none}hr{border:0;box-sizing:initial;display:block;height:.05rem;overflow:visible;padding:0}small{font-size:80%}sub,sup{line-height:1em}img{border-style:none}table{border-collapse:initial;border-spacing:0}td,th{font-weight:400;vertical-align:top}button{background:transparent;border:0;font-family:inherit;font-size:inherit;margin:0;padding:0}input{border:0;outline:none}:root,[data-md-color-scheme=default]{--md-default-fg-color:rgba(0,0,0,.87);--md-default-fg-color--light:rgba(0,0,0,.54);--md-default-fg-color--lighter:rgba(0,0,0,.32);--md-default-fg-color--lightest:rgba(0,0,0,.07);--md-default-bg-color:#fff;--md-default-bg-color--light:hsla(0,0%,100%,.7);--md-default-bg-color--lighter:hsla(0,0%,100%,.3);--md-default-bg-color--lightest:hsla(0,0%,100%,.12);--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:rgba(82,108,254,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7);--md-code-fg-color:#36464e;--md-code-bg-color:#f5f5f5;--md-code-hl-color:rgba(255,255,0,.5);--md-code-hl-number-color:#d52a2a;--md-code-hl-special-color:#db1457;--md-code-hl-function-color:#a846b9;--md-code-hl-constant-color:#6e59d9;--md-code-hl-keyword-color:#3f6ec6;--md-code-hl-string-color:#1c7d4d;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-mark-color:rgba(255,255,0,.5);--md-typeset-del-color:rgba(245,80,61,.15);--md-typeset-ins-color:rgba(11,213,112,.15);--md-typeset-kbd-color:#fafafa;--md-typeset-kbd-accent-color:#fff;--md-typeset-kbd-border-color:#b8b8b8;--md-typeset-table-color:rgba(0,0,0,.12);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-fg-color:#fff;--md-footer-fg-color--light:hsla(0,0%,100%,.7);--md-footer-fg-color--lighter:hsla(0,0%,100%,.3);--md-footer-bg-color:rgba(0,0,0,.87);--md-footer-bg-color--dark:rgba(0,0,0,.32);--md-shadow-z1:0 0.2rem 0.5rem rgba(0,0,0,.05),0 0 0.05rem rgba(0,0,0,.1);--md-shadow-z2:0 0.2rem 0.5rem rgba(0,0,0,.1),0 0 0.05rem rgba(0,0,0,.25);--md-shadow-z3:0 0.2rem 0.5rem rgba(0,0,0,.2),0 0 0.05rem rgba(0,0,0,.35)}.md-icon svg{fill:currentcolor;display:block;height:1.2rem;width:1.2rem}body{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;--md-text-font-family:var(--md-text-font,_),-apple-system,BlinkMacSystemFont,Helvetica,Arial,sans-serif;--md-code-font-family:var(--md-code-font,_),SFMono-Regular,Consolas,Menlo,monospace}body,input{font-feature-settings:"kern","liga";font-family:var(--md-text-font-family)}body,code,input,kbd,pre{color:var(--md-typeset-color)}code,kbd,pre{font-feature-settings:"kern";font-family:var(--md-code-font-family)}:root{--md-typeset-table-sort-icon:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--asc:url('data:image/svg+xml;charset=utf-8,');--md-typeset-table-sort-icon--desc:url('data:image/svg+xml;charset=utf-8,')}.md-typeset{-webkit-print-color-adjust:exact;color-adjust:exact;font-size:.8rem;line-height:1.6}@media print{.md-typeset{font-size:.68rem}}.md-typeset blockquote,.md-typeset dl,.md-typeset figure,.md-typeset ol,.md-typeset pre,.md-typeset ul{margin-bottom:1em;margin-top:1em}.md-typeset h1{color:var(--md-default-fg-color--light);font-size:2em;line-height:1.3;margin:0 0 1.25em}.md-typeset h1,.md-typeset h2{font-weight:300;letter-spacing:-.01em}.md-typeset h2{font-size:1.5625em;line-height:1.4;margin:1.6em 0 .64em}.md-typeset h3{font-size:1.25em;font-weight:400;letter-spacing:-.01em;line-height:1.5;margin:1.6em 0 .8em}.md-typeset h2+h3{margin-top:.8em}.md-typeset h4{font-weight:700;letter-spacing:-.01em;margin:1em 0}.md-typeset h5,.md-typeset h6{color:var(--md-default-fg-color--light);font-size:.8em;font-weight:700;letter-spacing:-.01em;margin:1.25em 0}.md-typeset h5{text-transform:uppercase}.md-typeset hr{border-bottom:.05rem solid var(--md-default-fg-color--lightest);display:flow-root;margin:1.5em 0}.md-typeset a{color:var(--md-typeset-a-color);word-break:break-word}.md-typeset a,.md-typeset a:before{transition:color 125ms}.md-typeset a:focus,.md-typeset a:hover{color:var(--md-accent-fg-color)}.md-typeset a:focus code,.md-typeset a:hover code{background-color:var(--md-accent-fg-color--transparent)}.md-typeset a code{color:currentcolor;transition:background-color 125ms}.md-typeset a.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset code,.md-typeset kbd,.md-typeset pre{color:var(--md-code-fg-color);direction:ltr;font-variant-ligatures:none}@media print{.md-typeset code,.md-typeset kbd,.md-typeset pre{white-space:pre-wrap}}.md-typeset code{background-color:var(--md-code-bg-color);border-radius:.1rem;-webkit-box-decoration-break:clone;box-decoration-break:clone;font-size:.85em;padding:0 .2941176471em;word-break:break-word}.md-typeset code:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-typeset pre{display:flow-root;line-height:1.4;position:relative}.md-typeset pre>code{-webkit-box-decoration-break:slice;box-decoration-break:slice;box-shadow:none;display:block;margin:0;outline-color:var(--md-accent-fg-color);overflow:auto;padding:.7720588235em 1.1764705882em;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin;touch-action:auto;word-break:normal}.md-typeset pre>code:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-typeset pre>code::-webkit-scrollbar{height:.2rem;width:.2rem}.md-typeset pre>code::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-typeset pre>code::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}.md-typeset kbd{background-color:var(--md-typeset-kbd-color);border-radius:.1rem;box-shadow:0 .1rem 0 .05rem var(--md-typeset-kbd-border-color),0 .1rem 0 var(--md-typeset-kbd-border-color),0 -.1rem .2rem var(--md-typeset-kbd-accent-color) inset;color:var(--md-default-fg-color);display:inline-block;font-size:.75em;padding:0 .6666666667em;vertical-align:text-top;word-break:break-word}.md-typeset mark{background-color:var(--md-typeset-mark-color);-webkit-box-decoration-break:clone;box-decoration-break:clone;color:inherit;word-break:break-word}.md-typeset abbr{border-bottom:.05rem dotted var(--md-default-fg-color--light);cursor:help;text-decoration:none}@media (hover:none){.md-typeset abbr{position:relative}.md-typeset abbr[title]:-webkit-any(:focus,:hover):after{background-color:var(--md-default-fg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z3);color:var(--md-default-bg-color);content:attr(title);display:inline-block;font-size:.7rem;margin-top:2em;max-width:80%;min-width:-webkit-max-content;min-width:max-content;padding:.2rem .3rem;position:absolute;width:auto}.md-typeset abbr[title]:-moz-any(:focus,:hover):after{background-color:var(--md-default-fg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z3);color:var(--md-default-bg-color);content:attr(title);display:inline-block;font-size:.7rem;margin-top:2em;max-width:80%;min-width:-moz-max-content;min-width:max-content;padding:.2rem .3rem;position:absolute;width:auto}[dir=ltr] .md-typeset abbr[title]:-webkit-any(:focus,:hover):after{left:0}[dir=ltr] .md-typeset abbr[title]:-moz-any(:focus,:hover):after{left:0}[dir=ltr] .md-typeset abbr[title]:is(:focus,:hover):after{left:0}[dir=rtl] .md-typeset abbr[title]:-webkit-any(:focus,:hover):after{right:0}[dir=rtl] .md-typeset abbr[title]:-moz-any(:focus,:hover):after{right:0}[dir=rtl] .md-typeset abbr[title]:is(:focus,:hover):after{right:0}.md-typeset abbr[title]:is(:focus,:hover):after{background-color:var(--md-default-fg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z3);color:var(--md-default-bg-color);content:attr(title);display:inline-block;font-size:.7rem;margin-top:2em;max-width:80%;min-width:-webkit-max-content;min-width:-moz-max-content;min-width:max-content;padding:.2rem .3rem;position:absolute;width:auto}}.md-typeset small{opacity:.75}[dir=ltr] .md-typeset sub,[dir=ltr] .md-typeset sup{margin-left:.078125em}[dir=rtl] .md-typeset sub,[dir=rtl] .md-typeset sup{margin-right:.078125em}[dir=ltr] .md-typeset blockquote{padding-left:.6rem}[dir=rtl] .md-typeset blockquote{padding-right:.6rem}[dir=ltr] .md-typeset blockquote{border-left:.2rem solid var(--md-default-fg-color--lighter)}[dir=rtl] .md-typeset blockquote{border-right:.2rem solid var(--md-default-fg-color--lighter)}.md-typeset blockquote{color:var(--md-default-fg-color--light);margin-left:0;margin-right:0}.md-typeset ul{list-style-type:disc}[dir=ltr] .md-typeset ol,[dir=ltr] .md-typeset ul{margin-left:.625em}[dir=rtl] .md-typeset ol,[dir=rtl] .md-typeset ul{margin-right:.625em}.md-typeset ol,.md-typeset ul{padding:0}.md-typeset ol:not([hidden]),.md-typeset ul:not([hidden]){display:flow-root}.md-typeset ol ol,.md-typeset ul ol{list-style-type:lower-alpha}.md-typeset ol ol ol,.md-typeset ul ol ol{list-style-type:lower-roman}[dir=ltr] .md-typeset ol li,[dir=ltr] .md-typeset ul li{margin-left:1.25em}[dir=rtl] .md-typeset ol li,[dir=rtl] .md-typeset ul li{margin-right:1.25em}.md-typeset ol li,.md-typeset ul li{margin-bottom:.5em}.md-typeset ol li blockquote,.md-typeset ol li p,.md-typeset ul li blockquote,.md-typeset ul li p{margin:.5em 0}.md-typeset ol li:last-child,.md-typeset ul li:last-child{margin-bottom:0}.md-typeset ol li :-webkit-any(ul,ol),.md-typeset ul li :-webkit-any(ul,ol){margin-bottom:.5em;margin-top:.5em}.md-typeset ol li :-moz-any(ul,ol),.md-typeset ul li :-moz-any(ul,ol){margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset ol li :-webkit-any(ul,ol),[dir=ltr] .md-typeset ul li :-webkit-any(ul,ol){margin-left:.625em}[dir=ltr] .md-typeset ol li :-moz-any(ul,ol),[dir=ltr] .md-typeset ul li :-moz-any(ul,ol){margin-left:.625em}[dir=ltr] .md-typeset ol li :is(ul,ol),[dir=ltr] .md-typeset ul li :is(ul,ol){margin-left:.625em}[dir=rtl] .md-typeset ol li :-webkit-any(ul,ol),[dir=rtl] .md-typeset ul li :-webkit-any(ul,ol){margin-right:.625em}[dir=rtl] .md-typeset ol li :-moz-any(ul,ol),[dir=rtl] .md-typeset ul li :-moz-any(ul,ol){margin-right:.625em}[dir=rtl] .md-typeset ol li :is(ul,ol),[dir=rtl] .md-typeset ul li :is(ul,ol){margin-right:.625em}.md-typeset ol li :is(ul,ol),.md-typeset ul li :is(ul,ol){margin-bottom:.5em;margin-top:.5em}[dir=ltr] .md-typeset dd{margin-left:1.875em}[dir=rtl] .md-typeset dd{margin-right:1.875em}.md-typeset dd{margin-bottom:1.5em;margin-top:1em}.md-typeset img,.md-typeset svg,.md-typeset video{height:auto;max-width:100%}.md-typeset img[align=left]{margin:1em 1em 1em 0}.md-typeset img[align=right]{margin:1em 0 1em 1em}.md-typeset img[align]:only-child{margin-top:0}.md-typeset img[src$="#gh-dark-mode-only"],.md-typeset img[src$="#only-dark"]{display:none}.md-typeset figure{display:flow-root;margin:1em auto;max-width:100%;text-align:center;width:-webkit-fit-content;width:-moz-fit-content;width:fit-content}.md-typeset figure img{display:block}.md-typeset figcaption{font-style:italic;margin:1em auto;max-width:24rem}.md-typeset iframe{max-width:100%}.md-typeset table:not([class]){background-color:var(--md-default-bg-color);border:.05rem solid var(--md-typeset-table-color);border-radius:.1rem;display:inline-block;font-size:.64rem;max-width:100%;overflow:auto;touch-action:auto}@media print{.md-typeset table:not([class]){display:table}}.md-typeset table:not([class])+*{margin-top:1.5em}.md-typeset table:not([class]) :-webkit-any(th,td)>:first-child{margin-top:0}.md-typeset table:not([class]) :-moz-any(th,td)>:first-child{margin-top:0}.md-typeset table:not([class]) :is(th,td)>:first-child{margin-top:0}.md-typeset table:not([class]) :-webkit-any(th,td)>:last-child{margin-bottom:0}.md-typeset table:not([class]) :-moz-any(th,td)>:last-child{margin-bottom:0}.md-typeset table:not([class]) :is(th,td)>:last-child{margin-bottom:0}.md-typeset table:not([class]) :-webkit-any(th,td):not([align]){text-align:left}.md-typeset table:not([class]) :-moz-any(th,td):not([align]){text-align:left}.md-typeset table:not([class]) :is(th,td):not([align]){text-align:left}[dir=rtl] .md-typeset table:not([class]) :-webkit-any(th,td):not([align]){text-align:right}[dir=rtl] .md-typeset table:not([class]) :-moz-any(th,td):not([align]){text-align:right}[dir=rtl] .md-typeset table:not([class]) :is(th,td):not([align]){text-align:right}.md-typeset table:not([class]) th{font-weight:700;min-width:5rem;padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) td{border-top:.05rem solid var(--md-typeset-table-color);padding:.9375em 1.25em;vertical-align:top}.md-typeset table:not([class]) tbody tr{transition:background-color 125ms}.md-typeset table:not([class]) tbody tr:hover{background-color:rgba(0,0,0,.035);box-shadow:0 .05rem 0 var(--md-default-bg-color) inset}.md-typeset table:not([class]) a{word-break:normal}.md-typeset table th[role=columnheader]{cursor:pointer}[dir=ltr] .md-typeset table th[role=columnheader]:after{margin-left:.5em}[dir=rtl] .md-typeset table th[role=columnheader]:after{margin-right:.5em}.md-typeset table th[role=columnheader]:after{content:"";display:inline-block;height:1.2em;-webkit-mask-image:var(--md-typeset-table-sort-icon);mask-image:var(--md-typeset-table-sort-icon);-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset table th[role=columnheader]:hover:after{background-color:var(--md-default-fg-color--lighter)}.md-typeset table th[role=columnheader][aria-sort=ascending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--asc);mask-image:var(--md-typeset-table-sort-icon--asc)}.md-typeset table th[role=columnheader][aria-sort=descending]:after{background-color:var(--md-default-fg-color--light);-webkit-mask-image:var(--md-typeset-table-sort-icon--desc);mask-image:var(--md-typeset-table-sort-icon--desc)}.md-typeset__scrollwrap{margin:1em -.8rem;overflow-x:auto;touch-action:auto}.md-typeset__table{display:inline-block;margin-bottom:.5em;padding:0 .8rem}@media print{.md-typeset__table{display:block}}html .md-typeset__table table{display:table;margin:0;overflow:hidden;width:100%}@media screen and (max-width:44.9375em){.md-content__inner>pre{margin:1em -.8rem}.md-content__inner>pre code{border-radius:0}}.md-banner{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color);overflow:auto}@media print{.md-banner{display:none}}.md-banner--warning{background:var(--md-typeset-mark-color);color:var(--md-default-fg-color)}.md-banner__inner{font-size:.7rem;margin:.6rem auto;padding:0 .8rem}[dir=ltr] .md-banner__button{float:right}[dir=rtl] .md-banner__button{float:left}.md-banner__button{color:inherit;cursor:pointer;transition:opacity .25s}.md-banner__button:hover{opacity:.7}html{font-size:125%;height:100%;overflow-x:hidden}@media screen and (min-width:100em){html{font-size:137.5%}}@media screen and (min-width:125em){html{font-size:150%}}body{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;font-size:.5rem;min-height:100%;position:relative;width:100%}@media print{body{display:block}}@media screen and (max-width:59.9375em){body[data-md-scrolllock]{position:fixed}}.md-grid{margin-left:auto;margin-right:auto;max-width:61rem}.md-container{display:flex;flex-direction:column;flex-grow:1}@media print{.md-container{display:block}}.md-main{flex-grow:1}.md-main__inner{display:flex;height:100%;margin-top:1.5rem}.md-ellipsis{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.md-toggle{display:none}.md-option{height:0;opacity:0;position:absolute;width:0}.md-option:checked+label:not([hidden]){display:block}.md-option.focus-visible+label{outline-color:var(--md-accent-fg-color);outline-style:auto}.md-skip{background-color:var(--md-default-fg-color);border-radius:.1rem;color:var(--md-default-bg-color);font-size:.64rem;margin:.5rem;opacity:0;outline-color:var(--md-accent-fg-color);padding:.3rem .5rem;position:fixed;transform:translateY(.4rem);z-index:-1}.md-skip:focus{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 175ms 75ms;z-index:10}@page{margin:25mm}:root{--md-clipboard-icon:url('data:image/svg+xml;charset=utf-8,')}.md-clipboard{border-radius:.1rem;color:var(--md-default-fg-color--lightest);cursor:pointer;height:1.5em;outline-color:var(--md-accent-fg-color);outline-offset:.1rem;position:absolute;right:.5em;top:.5em;transition:color .25s;width:1.5em;z-index:1}@media print{.md-clipboard{display:none}}.md-clipboard:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}:hover>.md-clipboard{color:var(--md-default-fg-color--light)}.md-clipboard:-webkit-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-clipboard:-moz-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-clipboard:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-clipboard:after{background-color:currentcolor;content:"";display:block;height:1.125em;margin:0 auto;-webkit-mask-image:var(--md-clipboard-icon);mask-image:var(--md-clipboard-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:1.125em}.md-clipboard--inline{cursor:pointer}.md-clipboard--inline code{transition:color .25s,background-color .25s}.md-clipboard--inline:-webkit-any(:focus,:hover) code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-clipboard--inline:-moz-any(:focus,:hover) code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-clipboard--inline:is(:focus,:hover) code{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}@keyframes consent{0%{opacity:0;transform:translateY(100%)}to{opacity:1;transform:translateY(0)}}@keyframes overlay{0%{opacity:0}to{opacity:1}}.md-consent__overlay{animation:overlay .25s both;-webkit-backdrop-filter:blur(.1rem);backdrop-filter:blur(.1rem);background-color:rgba(0,0,0,.54);height:100%;opacity:1;position:fixed;top:0;width:100%;z-index:5}.md-consent__inner{animation:consent .5s cubic-bezier(.1,.7,.1,1) both;background-color:var(--md-default-bg-color);border:0;border-radius:.1rem;bottom:0;box-shadow:0 0 .2rem rgba(0,0,0,.1),0 .2rem .4rem rgba(0,0,0,.2);max-height:100%;overflow:auto;padding:0;position:fixed;width:100%;z-index:5}.md-consent__form{padding:.8rem}.md-consent__settings{display:none;margin:1em 0}input:checked+.md-consent__settings{display:block}.md-consent__controls{margin-bottom:.8rem}.md-typeset .md-consent__controls .md-button{display:inline}@media screen and (max-width:44.9375em){.md-typeset .md-consent__controls .md-button{display:block;margin-top:.4rem;text-align:center;width:100%}}.md-consent label{cursor:pointer}.md-content{flex-grow:1;min-width:0}.md-content__inner{margin:0 .8rem 1.2rem;padding-top:.6rem}@media screen and (min-width:76.25em){[dir=ltr] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}[dir=ltr] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner,[dir=rtl] .md-sidebar--primary:not([hidden])~.md-content>.md-content__inner{margin-right:1.2rem}[dir=rtl] .md-sidebar--secondary:not([hidden])~.md-content>.md-content__inner{margin-left:1.2rem}}.md-content__inner:before{content:"";display:block;height:.4rem}.md-content__inner>:last-child{margin-bottom:0}[dir=ltr] .md-content__button{float:right}[dir=rtl] .md-content__button{float:left}[dir=ltr] .md-content__button{margin-left:.4rem}[dir=rtl] .md-content__button{margin-right:.4rem}.md-content__button{margin:.4rem 0;padding:0}@media print{.md-content__button{display:none}}.md-typeset .md-content__button{color:var(--md-default-fg-color--lighter)}.md-content__button svg{display:inline;vertical-align:top}[dir=rtl] .md-content__button svg{transform:scaleX(-1)}[dir=ltr] .md-dialog{right:.8rem}[dir=rtl] .md-dialog{left:.8rem}.md-dialog{background-color:var(--md-default-fg-color);border-radius:.1rem;bottom:.8rem;box-shadow:var(--md-shadow-z3);min-width:11.1rem;opacity:0;padding:.4rem .6rem;pointer-events:none;position:fixed;transform:translateY(100%);transition:transform 0ms .4s,opacity .4s;z-index:4}@media print{.md-dialog{display:none}}.md-dialog--active{opacity:1;pointer-events:auto;transform:translateY(0);transition:transform .4s cubic-bezier(.075,.85,.175,1),opacity .4s}.md-dialog__inner{color:var(--md-default-bg-color);font-size:.7rem}.md-feedback{margin:2em 0 1em;text-align:center}.md-feedback fieldset{border:none;margin:0;padding:0}.md-feedback__title{font-weight:700;margin:1em auto}.md-feedback__inner{position:relative}.md-feedback__list{align-content:baseline;display:flex;flex-wrap:wrap;justify-content:center;position:relative}.md-feedback__list:hover .md-icon:not(:disabled){color:var(--md-default-fg-color--lighter)}:disabled .md-feedback__list{min-height:1.8rem}.md-feedback__icon{color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;margin:0 .1rem;transition:color 125ms}.md-feedback__icon:not(:disabled).md-icon:hover{color:var(--md-accent-fg-color)}.md-feedback__icon:disabled{color:var(--md-default-fg-color--lightest);pointer-events:none}.md-feedback__note{opacity:0;position:relative;transform:translateY(.4rem);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-feedback__note>*{margin:0 auto;max-width:16rem}:disabled .md-feedback__note{opacity:1;transform:translateY(0)}.md-footer{background-color:var(--md-footer-bg-color);color:var(--md-footer-fg-color)}@media print{.md-footer{display:none}}.md-footer__inner{justify-content:space-between;overflow:auto;padding:.2rem}.md-footer__inner:not([hidden]){display:flex}.md-footer__link{display:flex;flex-grow:0.01;outline-color:var(--md-accent-fg-color);overflow:hidden;padding-bottom:.4rem;padding-top:1.4rem;transition:opacity .25s}.md-footer__link:-webkit-any(:focus,:hover){opacity:.7}.md-footer__link:-moz-any(:focus,:hover){opacity:.7}.md-footer__link:is(:focus,:hover){opacity:.7}[dir=rtl] .md-footer__link svg{transform:scaleX(-1)}@media screen and (max-width:44.9375em){.md-footer__link--prev .md-footer__title{display:none}}[dir=ltr] .md-footer__link--next{margin-left:auto}[dir=rtl] .md-footer__link--next{margin-right:auto}.md-footer__link--next{text-align:right}[dir=rtl] .md-footer__link--next{text-align:left}.md-footer__title{flex-grow:1;font-size:.9rem;line-height:2.4rem;max-width:calc(100% - 2.4rem);padding:0 1rem;position:relative;white-space:nowrap}.md-footer__button{margin:.2rem;padding:.4rem}.md-footer__direction{font-size:.64rem;left:0;margin-top:-1rem;opacity:.7;padding:0 1rem;position:absolute;right:0}.md-footer-meta{background-color:var(--md-footer-bg-color--dark)}.md-footer-meta__inner{display:flex;flex-wrap:wrap;justify-content:space-between;padding:.2rem}html .md-footer-meta.md-typeset a{color:var(--md-footer-fg-color--light)}html .md-footer-meta.md-typeset a:-webkit-any(:focus,:hover){color:var(--md-footer-fg-color)}html .md-footer-meta.md-typeset a:-moz-any(:focus,:hover){color:var(--md-footer-fg-color)}html .md-footer-meta.md-typeset a:is(:focus,:hover){color:var(--md-footer-fg-color)}.md-copyright{color:var(--md-footer-fg-color--lighter);font-size:.64rem;margin:auto .6rem;padding:.4rem 0;width:100%}@media screen and (min-width:45em){.md-copyright{width:auto}}.md-copyright__highlight{color:var(--md-footer-fg-color--light)}.md-social{margin:0 .4rem;padding:.2rem 0 .6rem}@media screen and (min-width:45em){.md-social{padding:.6rem 0}}.md-social__link{display:inline-block;height:1.6rem;text-align:center;width:1.6rem}.md-social__link:before{line-height:1.9}.md-social__link svg{fill:currentcolor;max-height:.8rem;vertical-align:-25%}.md-typeset .md-button{border:.1rem solid;border-radius:.1rem;color:var(--md-primary-fg-color);cursor:pointer;display:inline-block;font-weight:700;padding:.625em 2em;transition:color 125ms,background-color 125ms,border-color 125ms}.md-typeset .md-button--primary{background-color:var(--md-primary-fg-color);border-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color)}.md-typeset .md-button:-webkit-any(:focus,:hover){background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-typeset .md-button:-moz-any(:focus,:hover){background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-typeset .md-button:is(:focus,:hover){background-color:var(--md-accent-fg-color);border-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[dir=ltr] .md-typeset .md-input{border-top-left-radius:.1rem}[dir=ltr] .md-typeset .md-input,[dir=rtl] .md-typeset .md-input{border-top-right-radius:.1rem}[dir=rtl] .md-typeset .md-input{border-top-left-radius:.1rem}.md-typeset .md-input{border-bottom:.1rem solid var(--md-default-fg-color--lighter);box-shadow:var(--md-shadow-z1);font-size:.8rem;height:1.8rem;padding:0 .6rem;transition:border .25s,box-shadow .25s}.md-typeset .md-input:-webkit-any(:focus,:hover){border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input:-moz-any(:focus,:hover){border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input:is(:focus,:hover){border-bottom-color:var(--md-accent-fg-color);box-shadow:var(--md-shadow-z2)}.md-typeset .md-input--stretch{width:100%}.md-header{background-color:var(--md-primary-fg-color);box-shadow:0 0 .2rem transparent,0 .2rem .4rem transparent;color:var(--md-primary-bg-color);display:block;left:0;position:-webkit-sticky;position:sticky;right:0;top:0;z-index:4}@media print{.md-header{display:none}}.md-header[hidden]{transform:translateY(-100%);transition:transform .25s cubic-bezier(.8,0,.6,1),box-shadow .25s}.md-header--shadow{box-shadow:0 0 .2rem rgba(0,0,0,.1),0 .2rem .4rem rgba(0,0,0,.2);transition:transform .25s cubic-bezier(.1,.7,.1,1),box-shadow .25s}.md-header__inner{align-items:center;display:flex;padding:0 .2rem}.md-header__button{color:currentcolor;cursor:pointer;margin:.2rem;outline-color:var(--md-accent-fg-color);padding:.4rem;position:relative;transition:opacity .25s;vertical-align:middle;z-index:1}.md-header__button:hover{opacity:.7}.md-header__button:not([hidden]){display:inline-block}.md-header__button:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}.md-header__button.md-logo{margin:.2rem;padding:.4rem}@media screen and (max-width:76.1875em){.md-header__button.md-logo{display:none}}.md-header__button.md-logo :-webkit-any(img,svg){fill:currentcolor;display:block;height:1.2rem;width:auto}.md-header__button.md-logo :-moz-any(img,svg){fill:currentcolor;display:block;height:1.2rem;width:auto}.md-header__button.md-logo :is(img,svg){fill:currentcolor;display:block;height:1.2rem;width:auto}@media screen and (min-width:60em){.md-header__button[for=__search]{display:none}}.no-js .md-header__button[for=__search]{display:none}[dir=rtl] .md-header__button[for=__search] svg{transform:scaleX(-1)}@media screen and (min-width:76.25em){.md-header__button[for=__drawer]{display:none}}.md-header__topic{display:flex;max-width:100%;position:absolute;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;white-space:nowrap}.md-header__topic+.md-header__topic{opacity:0;pointer-events:none;transform:translateX(1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__topic+.md-header__topic{transform:translateX(-1.25rem)}.md-header__topic:first-child{font-weight:700}[dir=ltr] .md-header__title{margin-right:.4rem}[dir=rtl] .md-header__title{margin-left:.4rem}[dir=ltr] .md-header__title{margin-left:1rem}[dir=rtl] .md-header__title{margin-right:1rem}.md-header__title{flex-grow:1;font-size:.9rem;height:2.4rem;line-height:2.4rem}.md-header__title--active .md-header__topic{opacity:0;pointer-events:none;transform:translateX(-1.25rem);transition:transform .4s cubic-bezier(1,.7,.1,.1),opacity .15s;z-index:-1}[dir=rtl] .md-header__title--active .md-header__topic{transform:translateX(1.25rem)}.md-header__title--active .md-header__topic+.md-header__topic{opacity:1;pointer-events:auto;transform:translateX(0);transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .15s;z-index:0}.md-header__title>.md-header__ellipsis{height:100%;position:relative;width:100%}.md-header__option{display:flex;flex-shrink:0;max-width:100%;transition:max-width 0ms .25s,opacity .25s .25s;white-space:nowrap}[data-md-toggle=search]:checked~.md-header .md-header__option{max-width:0;opacity:0;transition:max-width 0ms,opacity 0ms}.md-header__source{display:none}@media screen and (min-width:60em){[dir=ltr] .md-header__source{margin-left:1rem}[dir=rtl] .md-header__source{margin-right:1rem}.md-header__source{display:block;max-width:11.7rem;width:11.7rem}}@media screen and (min-width:76.25em){[dir=ltr] .md-header__source{margin-left:1.4rem}[dir=rtl] .md-header__source{margin-right:1.4rem}}:root{--md-nav-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-nav-icon--next:url('data:image/svg+xml;charset=utf-8,');--md-toc-icon:url('data:image/svg+xml;charset=utf-8,')}.md-nav{font-size:.7rem;line-height:1.3}.md-nav__title{display:block;font-weight:700;overflow:hidden;padding:0 .6rem;text-overflow:ellipsis}.md-nav__title .md-nav__button{display:none}.md-nav__title .md-nav__button img{height:100%;width:auto}.md-nav__title .md-nav__button.md-logo :-webkit-any(img,svg){fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__title .md-nav__button.md-logo :-moz-any(img,svg){fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__title .md-nav__button.md-logo :is(img,svg){fill:currentcolor;display:block;height:2.4rem;max-width:100%;object-fit:contain;width:auto}.md-nav__list{list-style:none;margin:0;padding:0}.md-nav__item{padding:0 .6rem}[dir=ltr] .md-nav__item .md-nav__item{padding-right:0}[dir=rtl] .md-nav__item .md-nav__item{padding-left:0}.md-nav__link{align-items:center;cursor:pointer;display:flex;justify-content:space-between;margin-top:.625em;overflow:hidden;scroll-snap-align:start;text-overflow:ellipsis;transition:color 125ms}.md-nav__link--passed{color:var(--md-default-fg-color--light)}.md-nav__item .md-nav__link--active{color:var(--md-typeset-a-color)}.md-nav__item .md-nav__link--index [href]{width:100%}.md-nav__link:-webkit-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav__link:-moz-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav__link.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-nav--primary .md-nav__link[for=__toc]{display:none}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{background-color:currentcolor;display:block;height:100%;-webkit-mask-image:var(--md-toc-icon);mask-image:var(--md-toc-icon);width:100%}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:none}.md-nav__link>*{cursor:pointer;display:flex}.md-nav__icon{flex-shrink:0}.md-nav__source{display:none}@media screen and (max-width:76.1875em){.md-nav--primary,.md-nav--primary .md-nav{background-color:var(--md-default-bg-color);display:flex;flex-direction:column;height:100%;left:0;position:absolute;right:0;top:0;z-index:1}.md-nav--primary :-webkit-any(.md-nav__title,.md-nav__item){font-size:.8rem;line-height:1.5}.md-nav--primary :-moz-any(.md-nav__title,.md-nav__item){font-size:.8rem;line-height:1.5}.md-nav--primary :is(.md-nav__title,.md-nav__item){font-size:.8rem;line-height:1.5}.md-nav--primary .md-nav__title{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);cursor:pointer;height:5.6rem;line-height:2.4rem;padding:3rem .8rem .2rem;position:relative;white-space:nowrap}[dir=ltr] .md-nav--primary .md-nav__title .md-nav__icon{left:.4rem}[dir=rtl] .md-nav--primary .md-nav__title .md-nav__icon{right:.4rem}.md-nav--primary .md-nav__title .md-nav__icon{display:block;height:1.2rem;margin:.2rem;position:absolute;top:.4rem;width:1.2rem}.md-nav--primary .md-nav__title .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--prev);mask-image:var(--md-nav-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}.md-nav--primary .md-nav__title~.md-nav__list{background-color:var(--md-default-bg-color);box-shadow:0 .05rem 0 var(--md-default-fg-color--lightest) inset;overflow-y:auto;-ms-scroll-snap-type:y mandatory;scroll-snap-type:y mandatory;touch-action:pan-y}.md-nav--primary .md-nav__title~.md-nav__list>:first-child{border-top:0}.md-nav--primary .md-nav__title[for=__drawer]{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);font-weight:700}.md-nav--primary .md-nav__title .md-logo{display:block;left:.2rem;margin:.2rem;padding:.4rem;position:absolute;right:.2rem;top:.2rem}.md-nav--primary .md-nav__list{flex:1}.md-nav--primary .md-nav__item{border-top:.05rem solid var(--md-default-fg-color--lightest);padding:0}.md-nav--primary .md-nav__item--active>.md-nav__link{color:var(--md-typeset-a-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:-webkit-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:-moz-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__item--active>.md-nav__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-nav--primary .md-nav__link{margin-top:0;padding:.6rem .8rem}[dir=ltr] .md-nav--primary .md-nav__link .md-nav__icon{margin-right:-.2rem}[dir=rtl] .md-nav--primary .md-nav__link .md-nav__icon{margin-left:-.2rem}.md-nav--primary .md-nav__link .md-nav__icon{font-size:1.2rem;height:1.2rem;width:1.2rem}.md-nav--primary .md-nav__link .md-nav__icon:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-nav--primary .md-nav__icon:after{transform:scale(-1)}.md-nav--primary .md-nav--secondary .md-nav{background-color:initial;position:static}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-left:1.4rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav__link{padding-right:1.4rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-left:2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav__link{padding-right:2rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-left:2.6rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav__link{padding-right:2.6rem}[dir=ltr] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-left:3.2rem}[dir=rtl] .md-nav--primary .md-nav--secondary .md-nav .md-nav .md-nav .md-nav .md-nav__link{padding-right:3.2rem}.md-nav--secondary{background-color:initial}.md-nav__toggle~.md-nav{display:flex;opacity:0;transform:translateX(100%);transition:transform .25s cubic-bezier(.8,0,.6,1),opacity 125ms 50ms}[dir=rtl] .md-nav__toggle~.md-nav{transform:translateX(-100%)}.md-nav__toggle:checked~.md-nav{opacity:1;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),opacity 125ms 125ms}.md-nav__toggle:checked~.md-nav>.md-nav__list{-webkit-backface-visibility:hidden;backface-visibility:hidden}}@media screen and (max-width:59.9375em){.md-nav--primary .md-nav__link[for=__toc]{display:flex}.md-nav--primary .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--primary .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--primary .md-nav__link[for=__toc]~.md-nav{display:flex}.md-nav__source{background-color:var(--md-primary-fg-color--dark);color:var(--md-primary-bg-color);display:block;padding:0 .2rem}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-nav--integrated .md-nav__link[for=__toc]{display:flex}.md-nav--integrated .md-nav__link[for=__toc] .md-icon:after{content:""}.md-nav--integrated .md-nav__link[for=__toc]+.md-nav__link{display:none}.md-nav--integrated .md-nav__link[for=__toc]~.md-nav{display:flex}}@media screen and (min-width:60em){.md-nav--secondary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:-webkit-sticky;position:sticky;top:0;z-index:1}.md-nav--secondary .md-nav__title[for=__toc]{scroll-snap-align:start}.md-nav--secondary .md-nav__title .md-nav__icon{display:none}}@media screen and (min-width:76.25em){.md-nav{transition:max-height .25s cubic-bezier(.86,0,.07,1)}.md-nav--primary .md-nav__title{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);position:-webkit-sticky;position:sticky;top:0;z-index:1}.md-nav--primary .md-nav__title[for=__drawer]{scroll-snap-align:start}.md-nav--primary .md-nav__title .md-nav__icon,.md-nav__toggle~.md-nav{display:none}.md-nav__toggle:-webkit-any(:checked,:indeterminate)~.md-nav{display:block}.md-nav__toggle:-moz-any(:checked,:indeterminate)~.md-nav{display:block}.md-nav__toggle:is(:checked,:indeterminate)~.md-nav{display:block}.md-nav__item--nested>.md-nav>.md-nav__title{display:none}.md-nav__item--section{display:block;margin:1.25em 0}.md-nav__item--section:last-child{margin-bottom:0}.md-nav__item--section>.md-nav__link{font-weight:700;pointer-events:none}.md-nav__item--section>.md-nav__link--index [href]{pointer-events:auto}.md-nav__item--section>.md-nav__link .md-nav__icon{display:none}.md-nav__item--section>.md-nav{display:block}.md-nav__item--section>.md-nav>.md-nav__list>.md-nav__item{padding:0}.md-nav__icon{border-radius:100%;height:.9rem;transition:background-color .25s,transform .25s;width:.9rem}[dir=rtl] .md-nav__icon{transform:rotate(180deg)}.md-nav__icon:hover{background-color:var(--md-accent-fg-color--transparent)}.md-nav__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-nav-icon--next);mask-image:var(--md-nav-icon--next);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:-.1rem;width:100%}.md-nav__item--nested .md-nav__toggle:checked~.md-nav__link .md-nav__icon,.md-nav__item--nested .md-nav__toggle:indeterminate~.md-nav__link .md-nav__icon{transform:rotate(90deg)}.md-nav--lifted>.md-nav__list>.md-nav__item,.md-nav--lifted>.md-nav__list>.md-nav__item--nested,.md-nav--lifted>.md-nav__title{display:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active{display:block;padding:0}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link{background:var(--md-default-bg-color);box-shadow:0 0 .4rem .4rem var(--md-default-bg-color);font-weight:700;margin-top:0;padding:0 .6rem;position:-webkit-sticky;position:sticky;top:0;z-index:1}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link:not(.md-nav__link--index){pointer-events:none}.md-nav--lifted>.md-nav__list>.md-nav__item--active>.md-nav__link .md-nav__icon{display:none}.md-nav--lifted .md-nav[data-md-level="1"]{display:block}[dir=ltr] .md-nav--lifted .md-nav[data-md-level="1"]>.md-nav__list>.md-nav__item{padding-right:.6rem}[dir=rtl] .md-nav--lifted .md-nav[data-md-level="1"]>.md-nav__list>.md-nav__item{padding-left:.6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested){padding:0 .6rem}.md-nav--integrated>.md-nav__list>.md-nav__item--active:not(.md-nav__item--nested)>.md-nav__link{padding:0}[dir=ltr] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-left:.05rem solid var(--md-primary-fg-color)}[dir=rtl] .md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{border-right:.05rem solid var(--md-primary-fg-color)}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary{display:block;margin-bottom:1.25em}.md-nav--integrated>.md-nav__list>.md-nav__item--active .md-nav--secondary>.md-nav__title{display:none}}:root{--md-search-result-icon:url('data:image/svg+xml;charset=utf-8,')}.md-search{position:relative}@media screen and (min-width:60em){.md-search{padding:.2rem 0}}.no-js .md-search{display:none}.md-search__overlay{opacity:0;z-index:1}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__overlay{left:-2.2rem}[dir=rtl] .md-search__overlay{right:-2.2rem}.md-search__overlay{background-color:var(--md-default-bg-color);border-radius:1rem;height:2rem;overflow:hidden;pointer-events:none;position:absolute;top:-1rem;transform-origin:center;transition:transform .3s .1s,opacity .2s .2s;width:2rem}[data-md-toggle=search]:checked~.md-header .md-search__overlay{opacity:1;transition:transform .4s,opacity .1s}}@media screen and (min-width:60em){[dir=ltr] .md-search__overlay{left:0}[dir=rtl] .md-search__overlay{right:0}.md-search__overlay{background-color:rgba(0,0,0,.54);cursor:pointer;height:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0}[data-md-toggle=search]:checked~.md-header .md-search__overlay{height:200vh;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@media screen and (max-width:29.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(45)}}@media screen and (min-width:30em) and (max-width:44.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(60)}}@media screen and (min-width:45em) and (max-width:59.9375em){[data-md-toggle=search]:checked~.md-header .md-search__overlay{transform:scale(75)}}.md-search__inner{-webkit-backface-visibility:hidden;backface-visibility:hidden}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__inner{left:0}[dir=rtl] .md-search__inner{right:0}.md-search__inner{height:0;opacity:0;overflow:hidden;position:fixed;top:0;transform:translateX(5%);transition:width 0ms .3s,height 0ms .3s,transform .15s cubic-bezier(.4,0,.2,1) .15s,opacity .15s .15s;width:0;z-index:2}[dir=rtl] .md-search__inner{transform:translateX(-5%)}[data-md-toggle=search]:checked~.md-header .md-search__inner{height:100%;opacity:1;transform:translateX(0);transition:width 0ms 0ms,height 0ms 0ms,transform .15s cubic-bezier(.1,.7,.1,1) .15s,opacity .15s .15s;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__inner{float:right}[dir=rtl] .md-search__inner{float:left}.md-search__inner{padding:.1rem 0;position:relative;transition:width .25s cubic-bezier(.1,.7,.1,1);width:11.7rem}}@media screen and (min-width:60em) and (max-width:76.1875em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:23.4rem}}@media screen and (min-width:76.25em){[data-md-toggle=search]:checked~.md-header .md-search__inner{width:34.4rem}}.md-search__form{background-color:var(--md-default-bg-color);box-shadow:0 0 .6rem transparent;height:2.4rem;position:relative;transition:color .25s,background-color .25s;z-index:2}@media screen and (min-width:60em){.md-search__form{background-color:rgba(0,0,0,.26);border-radius:.1rem;height:1.8rem}.md-search__form:hover{background-color:hsla(0,0%,100%,.12)}}[data-md-toggle=search]:checked~.md-header .md-search__form{background-color:var(--md-default-bg-color);border-radius:.1rem .1rem 0 0;box-shadow:0 0 .6rem rgba(0,0,0,.07);color:var(--md-default-fg-color)}[dir=ltr] .md-search__input{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__input{padding-left:2.2rem;padding-right:3.6rem}.md-search__input{background:transparent;font-size:.9rem;height:100%;position:relative;text-overflow:ellipsis;width:100%;z-index:2}.md-search__input::-ms-input-placeholder{-ms-transition:color .25s;transition:color .25s}.md-search__input::placeholder{transition:color .25s}.md-search__input::-ms-input-placeholder{color:var(--md-default-fg-color--light)}.md-search__input::placeholder,.md-search__input~.md-search__icon{color:var(--md-default-fg-color--light)}.md-search__input::-ms-clear{display:none}@media screen and (max-width:59.9375em){.md-search__input{font-size:.9rem;height:2.4rem;width:100%}}@media screen and (min-width:60em){[dir=ltr] .md-search__input{padding-left:2.2rem}[dir=rtl] .md-search__input{padding-right:2.2rem}.md-search__input{color:inherit;font-size:.8rem}.md-search__input::-ms-input-placeholder{color:var(--md-primary-bg-color--light)}.md-search__input::placeholder{color:var(--md-primary-bg-color--light)}.md-search__input+.md-search__icon{color:var(--md-primary-bg-color)}[data-md-toggle=search]:checked~.md-header .md-search__input{text-overflow:clip}[data-md-toggle=search]:checked~.md-header .md-search__input::-ms-input-placeholder{color:var(--md-default-fg-color--light)}[data-md-toggle=search]:checked~.md-header .md-search__input+.md-search__icon,[data-md-toggle=search]:checked~.md-header .md-search__input::placeholder{color:var(--md-default-fg-color--light)}}.md-search__icon{cursor:pointer;display:inline-block;height:1.2rem;transition:color .25s,opacity .25s;width:1.2rem}.md-search__icon:hover{opacity:.7}[dir=ltr] .md-search__icon[for=__search]{left:.5rem}[dir=rtl] .md-search__icon[for=__search]{right:.5rem}.md-search__icon[for=__search]{position:absolute;top:.3rem;z-index:2}[dir=rtl] .md-search__icon[for=__search] svg{transform:scaleX(-1)}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__icon[for=__search]{left:.8rem}[dir=rtl] .md-search__icon[for=__search]{right:.8rem}.md-search__icon[for=__search]{top:.6rem}.md-search__icon[for=__search] svg:first-child{display:none}}@media screen and (min-width:60em){.md-search__icon[for=__search]{pointer-events:none}.md-search__icon[for=__search] svg:last-child{display:none}}[dir=ltr] .md-search__options{right:.5rem}[dir=rtl] .md-search__options{left:.5rem}.md-search__options{pointer-events:none;position:absolute;top:.3rem;z-index:2}@media screen and (max-width:59.9375em){[dir=ltr] .md-search__options{right:.8rem}[dir=rtl] .md-search__options{left:.8rem}.md-search__options{top:.6rem}}[dir=ltr] .md-search__options>*{margin-left:.2rem}[dir=rtl] .md-search__options>*{margin-right:.2rem}.md-search__options>*{color:var(--md-default-fg-color--light);opacity:0;transform:scale(.75);transition:transform .15s cubic-bezier(.1,.7,.1,1),opacity .15s}.md-search__options>:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>*{opacity:1;pointer-events:auto;transform:scale(1)}[data-md-toggle=search]:checked~.md-header .md-search__input:valid~.md-search__options>:hover{opacity:.7}[dir=ltr] .md-search__suggest{padding-left:3.6rem;padding-right:2.2rem}[dir=rtl] .md-search__suggest{padding-left:2.2rem;padding-right:3.6rem}.md-search__suggest{align-items:center;color:var(--md-default-fg-color--lighter);display:flex;font-size:.9rem;height:100%;opacity:0;position:absolute;top:0;transition:opacity 50ms;white-space:nowrap;width:100%}@media screen and (min-width:60em){[dir=ltr] .md-search__suggest{padding-left:2.2rem}[dir=rtl] .md-search__suggest{padding-right:2.2rem}.md-search__suggest{font-size:.8rem}}[data-md-toggle=search]:checked~.md-header .md-search__suggest{opacity:1;transition:opacity .3s .1s}[dir=ltr] .md-search__output{border-bottom-left-radius:.1rem}[dir=ltr] .md-search__output,[dir=rtl] .md-search__output{border-bottom-right-radius:.1rem}[dir=rtl] .md-search__output{border-bottom-left-radius:.1rem}.md-search__output{overflow:hidden;position:absolute;width:100%;z-index:1}@media screen and (max-width:59.9375em){.md-search__output{bottom:0;top:2.4rem}}@media screen and (min-width:60em){.md-search__output{opacity:0;top:1.9rem;transition:opacity .4s}[data-md-toggle=search]:checked~.md-header .md-search__output{box-shadow:var(--md-shadow-z3);opacity:1}}.md-search__scrollwrap{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);height:100%;overflow-y:auto;touch-action:pan-y}@media (-webkit-max-device-pixel-ratio:1),(max-resolution:1dppx){.md-search__scrollwrap{transform:translateZ(0)}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-search__scrollwrap{width:23.4rem}}@media screen and (min-width:76.25em){.md-search__scrollwrap{width:34.4rem}}@media screen and (min-width:60em){.md-search__scrollwrap{max-height:0;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin}[data-md-toggle=search]:checked~.md-header .md-search__scrollwrap{max-height:75vh}.md-search__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-search__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-search__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-search__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}}.md-search-result{color:var(--md-default-fg-color);word-break:break-word}.md-search-result__meta{background-color:var(--md-default-fg-color--lightest);color:var(--md-default-fg-color--light);font-size:.64rem;line-height:1.8rem;padding:0 .8rem;scroll-snap-align:start}@media screen and (min-width:60em){[dir=ltr] .md-search-result__meta{padding-left:2.2rem}[dir=rtl] .md-search-result__meta{padding-right:2.2rem}}.md-search-result__list{list-style:none;margin:0;padding:0;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.md-search-result__item{box-shadow:0 -.05rem var(--md-default-fg-color--lightest)}.md-search-result__item:first-child{box-shadow:none}.md-search-result__link{display:block;outline:none;scroll-snap-align:start;transition:background-color .25s}.md-search-result__link:-webkit-any(:focus,:hover){background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:-moz-any(:focus,:hover){background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:is(:focus,:hover){background-color:var(--md-accent-fg-color--transparent)}.md-search-result__link:last-child p:last-child{margin-bottom:.6rem}.md-search-result__more summary{color:var(--md-typeset-a-color);cursor:pointer;display:block;font-size:.64rem;outline:none;padding:.75em .8rem;scroll-snap-align:start;transition:color .25s,background-color .25s}@media screen and (min-width:60em){[dir=ltr] .md-search-result__more summary{padding-left:2.2rem}[dir=rtl] .md-search-result__more summary{padding-right:2.2rem}}.md-search-result__more summary:-webkit-any(:focus,:hover){background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more summary:-moz-any(:focus,:hover){background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more summary:is(:focus,:hover){background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-search-result__more summary::marker{display:none}.md-search-result__more summary::-webkit-details-marker{display:none}.md-search-result__more summary~*>*{opacity:.65}.md-search-result__article{overflow:hidden;padding:0 .8rem;position:relative}@media screen and (min-width:60em){[dir=ltr] .md-search-result__article{padding-left:2.2rem}[dir=rtl] .md-search-result__article{padding-right:2.2rem}}.md-search-result__article--document .md-search-result__title{font-size:.8rem;font-weight:400;line-height:1.4;margin:.55rem 0}[dir=ltr] .md-search-result__icon{left:0}[dir=rtl] .md-search-result__icon{right:0}.md-search-result__icon{color:var(--md-default-fg-color--light);height:1.2rem;margin:.5rem;position:absolute;width:1.2rem}@media screen and (max-width:59.9375em){.md-search-result__icon{display:none}}.md-search-result__icon:after{background-color:currentcolor;content:"";display:inline-block;height:100%;-webkit-mask-image:var(--md-search-result-icon);mask-image:var(--md-search-result-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:100%}[dir=rtl] .md-search-result__icon:after{transform:scaleX(-1)}.md-search-result__title{font-size:.64rem;font-weight:700;line-height:1.6;margin:.5em 0}.md-search-result__teaser{-webkit-box-orient:vertical;-webkit-line-clamp:2;color:var(--md-default-fg-color--light);display:-webkit-box;font-size:.64rem;line-height:1.6;margin:.5em 0;max-height:2rem;overflow:hidden;text-overflow:ellipsis}@media screen and (max-width:44.9375em){.md-search-result__teaser{-webkit-line-clamp:3;max-height:3rem}}@media screen and (min-width:60em) and (max-width:76.1875em){.md-search-result__teaser{-webkit-line-clamp:3;max-height:3rem}}.md-search-result__teaser mark{background-color:initial;text-decoration:underline}.md-search-result__terms{font-size:.64rem;font-style:italic;margin:.5em 0}.md-search-result mark{background-color:initial;color:var(--md-accent-fg-color)}.md-select{position:relative;z-index:1}.md-select__inner{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);left:50%;margin-top:.2rem;max-height:0;opacity:0;position:absolute;top:calc(100% - .2rem);transform:translate3d(-50%,.3rem,0);transition:transform .25s 375ms,opacity .25s .25s,max-height 0ms .5s}.md-select:-webkit-any(:focus-within,:hover) .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);-webkit-transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms;transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select:-moz-any(:focus-within,:hover) .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);-moz-transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms;transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select:is(:focus-within,:hover) .md-select__inner{max-height:10rem;opacity:1;transform:translate3d(-50%,0,0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,max-height 0ms}.md-select__inner:after{border-bottom:.2rem solid transparent;border-bottom-color:var(--md-default-bg-color);border-left:.2rem solid transparent;border-right:.2rem solid transparent;border-top:0;content:"";height:0;left:50%;margin-left:-.2rem;margin-top:-.2rem;position:absolute;top:0;width:0}.md-select__list{border-radius:.1rem;font-size:.8rem;list-style-type:none;margin:0;max-height:inherit;overflow:auto;padding:0}.md-select__item{line-height:1.8rem}[dir=ltr] .md-select__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-select__link{padding-left:1.2rem;padding-right:.6rem}.md-select__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:background-color .25s,color .25s;width:100%}.md-select__link:-webkit-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-select__link:-moz-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-select__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-select__link:focus{background-color:var(--md-default-fg-color--lightest)}.md-sidebar{align-self:flex-start;flex-shrink:0;padding:1.2rem 0;position:-webkit-sticky;position:sticky;top:2.4rem;width:12.1rem}@media print{.md-sidebar{display:none}}@media screen and (max-width:76.1875em){[dir=ltr] .md-sidebar--primary{left:-12.1rem}[dir=rtl] .md-sidebar--primary{right:-12.1rem}.md-sidebar--primary{background-color:var(--md-default-bg-color);display:block;height:100%;position:fixed;top:0;transform:translateX(0);transition:transform .25s cubic-bezier(.4,0,.2,1),box-shadow .25s;width:12.1rem;z-index:5}[data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{box-shadow:var(--md-shadow-z3);transform:translateX(12.1rem)}[dir=rtl] [data-md-toggle=drawer]:checked~.md-container .md-sidebar--primary{transform:translateX(-12.1rem)}.md-sidebar--primary .md-sidebar__scrollwrap{bottom:0;left:0;margin:0;overflow:hidden;position:absolute;right:0;-ms-scroll-snap-type:none;scroll-snap-type:none;top:0}}@media screen and (min-width:76.25em){.md-sidebar{height:0}.no-js .md-sidebar{height:auto}.md-header--lifted~.md-container .md-sidebar{top:4.8rem}}.md-sidebar--secondary{display:none;order:2}@media screen and (min-width:60em){.md-sidebar--secondary{height:0}.no-js .md-sidebar--secondary{height:auto}.md-sidebar--secondary:not([hidden]){display:block}.md-sidebar--secondary .md-sidebar__scrollwrap{touch-action:pan-y}}.md-sidebar__scrollwrap{scrollbar-gutter:stable;-webkit-backface-visibility:hidden;backface-visibility:hidden;margin:0 .2rem;overflow-y:auto;scrollbar-color:var(--md-default-fg-color--lighter) transparent;scrollbar-width:thin}.md-sidebar__scrollwrap:hover{scrollbar-color:var(--md-accent-fg-color) transparent}.md-sidebar__scrollwrap::-webkit-scrollbar{height:.2rem;width:.2rem}.md-sidebar__scrollwrap::-webkit-scrollbar-thumb{background-color:var(--md-default-fg-color--lighter)}.md-sidebar__scrollwrap::-webkit-scrollbar-thumb:hover{background-color:var(--md-accent-fg-color)}@supports selector(::-webkit-scrollbar){.md-sidebar__scrollwrap{scrollbar-gutter:auto}[dir=ltr] .md-sidebar__inner{padding-right:calc(100% - 11.5rem)}[dir=rtl] .md-sidebar__inner{padding-left:calc(100% - 11.5rem)}}@media screen and (max-width:76.1875em){.md-overlay{background-color:rgba(0,0,0,.54);height:0;opacity:0;position:fixed;top:0;transition:width 0ms .25s,height 0ms .25s,opacity .25s;width:0;z-index:5}[data-md-toggle=drawer]:checked~.md-overlay{height:100%;opacity:1;transition:width 0ms,height 0ms,opacity .25s;width:100%}}@keyframes facts{0%{height:0}to{height:.65rem}}@keyframes fact{0%{opacity:0;transform:translateY(100%)}50%{opacity:0}to{opacity:1;transform:translateY(0)}}:root{--md-source-forks-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-repositories-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-stars-icon:url('data:image/svg+xml;charset=utf-8,');--md-source-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-source{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.65rem;line-height:1.2;outline-color:var(--md-accent-fg-color);transition:opacity .25s;white-space:nowrap}.md-source:hover{opacity:.7}.md-source__icon{display:inline-block;height:2.4rem;vertical-align:middle;width:2rem}[dir=ltr] .md-source__icon svg{margin-left:.6rem}[dir=rtl] .md-source__icon svg{margin-right:.6rem}.md-source__icon svg{margin-top:.6rem}[dir=ltr] .md-source__icon+.md-source__repository{margin-left:-2rem}[dir=rtl] .md-source__icon+.md-source__repository{margin-right:-2rem}[dir=ltr] .md-source__icon+.md-source__repository{padding-left:2rem}[dir=rtl] .md-source__icon+.md-source__repository{padding-right:2rem}[dir=ltr] .md-source__repository{margin-left:.6rem}[dir=rtl] .md-source__repository{margin-right:.6rem}.md-source__repository{display:inline-block;max-width:calc(100% - 1.2rem);overflow:hidden;text-overflow:ellipsis;vertical-align:middle}.md-source__facts{display:flex;font-size:.55rem;gap:.4rem;list-style-type:none;margin:.1rem 0 0;opacity:.75;overflow:hidden;padding:0;width:100%}.md-source__repository--active .md-source__facts{animation:facts .25s ease-in}.md-source__fact{overflow:hidden;text-overflow:ellipsis}.md-source__repository--active .md-source__fact{animation:fact .4s ease-out}[dir=ltr] .md-source__fact:before{margin-right:.1rem}[dir=rtl] .md-source__fact:before{margin-left:.1rem}.md-source__fact:before{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;vertical-align:text-top;width:.6rem}.md-source__fact:nth-child(1n+2){flex-shrink:0}.md-source__fact--version:before{-webkit-mask-image:var(--md-source-version-icon);mask-image:var(--md-source-version-icon)}.md-source__fact--stars:before{-webkit-mask-image:var(--md-source-stars-icon);mask-image:var(--md-source-stars-icon)}.md-source__fact--forks:before{-webkit-mask-image:var(--md-source-forks-icon);mask-image:var(--md-source-forks-icon)}.md-source__fact--repositories:before{-webkit-mask-image:var(--md-source-repositories-icon);mask-image:var(--md-source-repositories-icon)}.md-tabs{background-color:var(--md-primary-fg-color);color:var(--md-primary-bg-color);display:block;line-height:1.3;overflow:auto;width:100%;z-index:3}@media print{.md-tabs{display:none}}@media screen and (max-width:76.1875em){.md-tabs{display:none}}.md-tabs[hidden]{pointer-events:none}[dir=ltr] .md-tabs__list{margin-left:.2rem}[dir=rtl] .md-tabs__list{margin-right:.2rem}.md-tabs__list{contain:content;list-style:none;margin:0;padding:0;white-space:nowrap}.md-tabs__item{display:inline-block;height:2.4rem;padding-left:.6rem;padding-right:.6rem}.md-tabs__link{-webkit-backface-visibility:hidden;backface-visibility:hidden;display:block;font-size:.7rem;margin-top:.8rem;opacity:.7;outline-color:var(--md-accent-fg-color);outline-offset:.2rem;transition:transform .4s cubic-bezier(.1,.7,.1,1),opacity .25s}.md-tabs__link--active,.md-tabs__link:-webkit-any(:focus,:hover){color:inherit;opacity:1}.md-tabs__link--active,.md-tabs__link:-moz-any(:focus,:hover){color:inherit;opacity:1}.md-tabs__link--active,.md-tabs__link:is(:focus,:hover){color:inherit;opacity:1}.md-tabs__item:nth-child(2) .md-tabs__link{transition-delay:20ms}.md-tabs__item:nth-child(3) .md-tabs__link{transition-delay:40ms}.md-tabs__item:nth-child(4) .md-tabs__link{transition-delay:60ms}.md-tabs__item:nth-child(5) .md-tabs__link{transition-delay:80ms}.md-tabs__item:nth-child(6) .md-tabs__link{transition-delay:.1s}.md-tabs__item:nth-child(7) .md-tabs__link{transition-delay:.12s}.md-tabs__item:nth-child(8) .md-tabs__link{transition-delay:.14s}.md-tabs__item:nth-child(9) .md-tabs__link{transition-delay:.16s}.md-tabs__item:nth-child(10) .md-tabs__link{transition-delay:.18s}.md-tabs__item:nth-child(11) .md-tabs__link{transition-delay:.2s}.md-tabs__item:nth-child(12) .md-tabs__link{transition-delay:.22s}.md-tabs__item:nth-child(13) .md-tabs__link{transition-delay:.24s}.md-tabs__item:nth-child(14) .md-tabs__link{transition-delay:.26s}.md-tabs__item:nth-child(15) .md-tabs__link{transition-delay:.28s}.md-tabs__item:nth-child(16) .md-tabs__link{transition-delay:.3s}.md-tabs[hidden] .md-tabs__link{opacity:0;transform:translateY(50%);transition:transform 0ms .1s,opacity .1s}:root{--md-tag-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .md-tags{margin-bottom:.75em;margin-top:-.125em}[dir=ltr] .md-typeset .md-tag{margin-right:.5em}[dir=rtl] .md-typeset .md-tag{margin-left:.5em}.md-typeset .md-tag{background:var(--md-default-fg-color--lightest);border-radius:2.4rem;display:inline-block;font-size:.64rem;font-weight:700;letter-spacing:normal;line-height:1.6;margin-bottom:.5em;padding:.3125em .9375em;vertical-align:middle}.md-typeset .md-tag[href]{-webkit-tap-highlight-color:transparent;color:inherit;outline:none;transition:color 125ms,background-color 125ms}.md-typeset .md-tag[href]:focus,.md-typeset .md-tag[href]:hover{background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}[id]>.md-typeset .md-tag{vertical-align:text-top}.md-typeset .md-tag-icon:before{background-color:var(--md-default-fg-color--lighter);content:"";display:inline-block;height:1.2em;margin-right:.4em;-webkit-mask-image:var(--md-tag-icon);mask-image:var(--md-tag-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color 125ms;vertical-align:text-bottom;width:1.2em}.md-typeset .md-tag-icon:-webkit-any(a:focus,a:hover):before{background-color:var(--md-accent-bg-color)}.md-typeset .md-tag-icon:-moz-any(a:focus,a:hover):before{background-color:var(--md-accent-bg-color)}.md-typeset .md-tag-icon:is(a:focus,a:hover):before{background-color:var(--md-accent-bg-color)}@keyframes pulse{0%{box-shadow:0 0 0 0 var(--md-default-fg-color--lightest);transform:scale(.95)}75%{box-shadow:0 0 0 .625em transparent;transform:scale(1)}to{box-shadow:0 0 0 0 transparent;transform:scale(.95)}}:root{--md-tooltip-width:20rem}.md-tooltip{-webkit-backface-visibility:hidden;backface-visibility:hidden;background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);font-family:var(--md-text-font-family);left:clamp(var(--md-tooltip-0,0rem) + .8rem,var(--md-tooltip-x),100vw + var(--md-tooltip-0,0rem) + .8rem - var(--md-tooltip-width) - 2 * .8rem);max-width:calc(100vw - 1.6rem);opacity:0;position:absolute;top:var(--md-tooltip-y);transform:translateY(-.4rem);transition:transform 0ms .25s,opacity .25s,z-index .25s;width:var(--md-tooltip-width);z-index:0}.md-tooltip--active{opacity:1;transform:translateY(0);transition:transform .25s cubic-bezier(.1,.7,.1,1),opacity .25s,z-index 0ms;z-index:2}:-webkit-any(.focus-visible>.md-tooltip,.md-tooltip:target){outline:var(--md-accent-fg-color) auto}:-moz-any(.focus-visible>.md-tooltip,.md-tooltip:target){outline:var(--md-accent-fg-color) auto}:is(.focus-visible>.md-tooltip,.md-tooltip:target){outline:var(--md-accent-fg-color) auto}.md-tooltip__inner{font-size:.64rem;padding:.8rem}.md-tooltip__inner.md-typeset>:first-child{margin-top:0}.md-tooltip__inner.md-typeset>:last-child{margin-bottom:0}.md-annotation{font-weight:400;outline:none;white-space:normal}[dir=rtl] .md-annotation{direction:rtl}.md-annotation:not([hidden]){display:inline-block;line-height:1.325}.md-annotation__index{cursor:pointer;font-family:var(--md-code-font-family);font-size:.85em;margin:0 1ch;outline:none;position:relative;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;z-index:0}.md-annotation .md-annotation__index{color:#fff;transition:z-index .25s}.md-annotation .md-annotation__index:-webkit-any(:focus,:hover){color:#fff}.md-annotation .md-annotation__index:-moz-any(:focus,:hover){color:#fff}.md-annotation .md-annotation__index:is(:focus,:hover){color:#fff}.md-annotation__index:after{background-color:var(--md-default-fg-color--lighter);border-radius:2ch;content:"";height:2.2ch;left:-.125em;margin:0 -.4ch;padding:0 .4ch;position:absolute;top:0;transition:color .25s,background-color .25s;width:calc(100% + 1.2ch);width:max(2.2ch,100% + 1.2ch);z-index:-1}@media not all and (prefers-reduced-motion){[data-md-visible]>.md-annotation__index:after{animation:pulse 2s infinite}}.md-tooltip--active+.md-annotation__index:after{animation:none;transition:color .25s,background-color .25s}code .md-annotation__index{font-family:var(--md-code-font-family);font-size:inherit}:-webkit-any(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index){color:var(--md-accent-bg-color)}:-moz-any(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index){color:var(--md-accent-bg-color)}:is(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index){color:var(--md-accent-bg-color)}:-webkit-any(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index):after{background-color:var(--md-accent-fg-color)}:-moz-any(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index):after{background-color:var(--md-accent-fg-color)}:is(.md-tooltip--active+.md-annotation__index,:hover>.md-annotation__index):after{background-color:var(--md-accent-fg-color)}.md-tooltip--active+.md-annotation__index{animation:none;transition:none;z-index:2}.md-annotation__index [data-md-annotation-id]{display:inline-block;line-height:90%}.md-annotation__index [data-md-annotation-id]:before{content:attr(data-md-annotation-id);display:inline-block;padding-bottom:.1em;transform:scale(1.15);transition:transform .4s cubic-bezier(.1,.7,.1,1);vertical-align:.065em}@media not print{.md-annotation__index [data-md-annotation-id]:before{content:"+"}:focus-within>.md-annotation__index [data-md-annotation-id]:before{transform:scale(1.25) rotate(45deg)}}[dir=ltr] .md-top{margin-left:50%}[dir=rtl] .md-top{margin-right:50%}.md-top{background-color:var(--md-default-bg-color);border-radius:1.6rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color--light);display:block;font-size:.7rem;outline:none;padding:.4rem .8rem;position:fixed;top:3.2rem;transform:translate(-50%);transition:color 125ms,background-color 125ms,transform 125ms cubic-bezier(.4,0,.2,1),opacity 125ms;z-index:2}@media print{.md-top{display:none}}[dir=rtl] .md-top{transform:translate(50%)}.md-top[hidden]{opacity:0;pointer-events:none;transform:translate(-50%,.2rem);transition-duration:0ms}[dir=rtl] .md-top[hidden]{transform:translate(50%,.2rem)}.md-top:-webkit-any(:focus,:hover){background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top:-moz-any(:focus,:hover){background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top:is(:focus,:hover){background-color:var(--md-accent-fg-color);color:var(--md-accent-bg-color)}.md-top svg{display:inline-block;vertical-align:-.5em}@keyframes hoverfix{0%{pointer-events:none}}:root{--md-version-icon:url('data:image/svg+xml;charset=utf-8,')}.md-version{flex-shrink:0;font-size:.8rem;height:2.4rem}[dir=ltr] .md-version__current{margin-left:1.4rem;margin-right:.4rem}[dir=rtl] .md-version__current{margin-left:.4rem;margin-right:1.4rem}.md-version__current{color:inherit;cursor:pointer;outline:none;position:relative;top:.05rem}[dir=ltr] .md-version__current:after{margin-left:.4rem}[dir=rtl] .md-version__current:after{margin-right:.4rem}.md-version__current:after{background-color:currentcolor;content:"";display:inline-block;height:.6rem;-webkit-mask-image:var(--md-version-icon);mask-image:var(--md-version-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.4rem}.md-version__list{background-color:var(--md-default-bg-color);border-radius:.1rem;box-shadow:var(--md-shadow-z2);color:var(--md-default-fg-color);list-style-type:none;margin:.2rem .8rem;max-height:0;opacity:0;overflow:auto;padding:0;position:absolute;-ms-scroll-snap-type:y mandatory;scroll-snap-type:y mandatory;top:.15rem;transition:max-height 0ms .5s,opacity .25s .25s;z-index:3}.md-version:-webkit-any(:focus-within,:hover) .md-version__list{max-height:10rem;opacity:1;-webkit-transition:max-height 0ms,opacity .25s;transition:max-height 0ms,opacity .25s}.md-version:-moz-any(:focus-within,:hover) .md-version__list{max-height:10rem;opacity:1;-moz-transition:max-height 0ms,opacity .25s;transition:max-height 0ms,opacity .25s}.md-version:is(:focus-within,:hover) .md-version__list{max-height:10rem;opacity:1;transition:max-height 0ms,opacity .25s}@media (pointer:coarse){.md-version:hover .md-version__list{animation:hoverfix .25s forwards}.md-version:focus-within .md-version__list{animation:none}}.md-version__item{line-height:1.8rem}[dir=ltr] .md-version__link{padding-left:.6rem;padding-right:1.2rem}[dir=rtl] .md-version__link{padding-left:1.2rem;padding-right:.6rem}.md-version__link{cursor:pointer;display:block;outline:none;scroll-snap-align:start;transition:color .25s,background-color .25s;white-space:nowrap;width:100%}.md-version__link:-webkit-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-version__link:-moz-any(:focus,:hover){color:var(--md-accent-fg-color)}.md-version__link:is(:focus,:hover){color:var(--md-accent-fg-color)}.md-version__link:focus{background-color:var(--md-default-fg-color--lightest)}:root{--md-admonition-icon--note:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--abstract:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--info:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--tip:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--success:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--question:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--warning:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--failure:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--danger:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--bug:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--example:url('data:image/svg+xml;charset=utf-8,');--md-admonition-icon--quote:url('data:image/svg+xml;charset=utf-8,')}.md-typeset :-webkit-any(.admonition,details){background-color:var(--md-admonition-bg-color);border:0 solid #448aff;border-radius:.1rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid}.md-typeset :-moz-any(.admonition,details){background-color:var(--md-admonition-bg-color);border:0 solid #448aff;border-radius:.1rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid}[dir=ltr] .md-typeset :-webkit-any(.admonition,details){border-left-width:.2rem}[dir=ltr] .md-typeset :-moz-any(.admonition,details){border-left-width:.2rem}[dir=ltr] .md-typeset :is(.admonition,details){border-left-width:.2rem}[dir=rtl] .md-typeset :-webkit-any(.admonition,details){border-right-width:.2rem}[dir=rtl] .md-typeset :-moz-any(.admonition,details){border-right-width:.2rem}[dir=rtl] .md-typeset :is(.admonition,details){border-right-width:.2rem}.md-typeset :is(.admonition,details){background-color:var(--md-admonition-bg-color);border:0 solid #448aff;border-radius:.1rem;box-shadow:var(--md-shadow-z1);color:var(--md-admonition-fg-color);display:flow-root;font-size:.64rem;margin:1.5625em 0;padding:0 .6rem;page-break-inside:avoid}@media print{.md-typeset :-webkit-any(.admonition,details){box-shadow:none}.md-typeset :-moz-any(.admonition,details){box-shadow:none}.md-typeset :is(.admonition,details){box-shadow:none}}.md-typeset :-webkit-any(.admonition,details)>*{box-sizing:border-box}.md-typeset :-moz-any(.admonition,details)>*{box-sizing:border-box}.md-typeset :is(.admonition,details)>*{box-sizing:border-box}.md-typeset :-webkit-any(.admonition,details) :-webkit-any(.admonition,details){margin-bottom:1em;margin-top:1em}.md-typeset :-moz-any(.admonition,details) :-moz-any(.admonition,details){margin-bottom:1em;margin-top:1em}.md-typeset :is(.admonition,details) :is(.admonition,details){margin-bottom:1em;margin-top:1em}.md-typeset :-webkit-any(.admonition,details) .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset :-moz-any(.admonition,details) .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset :is(.admonition,details) .md-typeset__scrollwrap{margin:1em -.6rem}.md-typeset :-webkit-any(.admonition,details) .md-typeset__table{padding:0 .6rem}.md-typeset :-moz-any(.admonition,details) .md-typeset__table{padding:0 .6rem}.md-typeset :is(.admonition,details) .md-typeset__table{padding:0 .6rem}.md-typeset :-webkit-any(.admonition,details)>.tabbed-set:only-child{margin-top:0}.md-typeset :-moz-any(.admonition,details)>.tabbed-set:only-child{margin-top:0}.md-typeset :is(.admonition,details)>.tabbed-set:only-child{margin-top:0}html .md-typeset :-webkit-any(.admonition,details)>:last-child{margin-bottom:.6rem}html .md-typeset :-moz-any(.admonition,details)>:last-child{margin-bottom:.6rem}html .md-typeset :is(.admonition,details)>:last-child{margin-bottom:.6rem}.md-typeset :-webkit-any(.admonition-title,summary){background-color:rgba(68,138,255,.1);border:none;font-weight:700;margin-bottom:0;margin-top:0;padding-bottom:.4rem;padding-top:.4rem;position:relative}.md-typeset :-moz-any(.admonition-title,summary){background-color:rgba(68,138,255,.1);border:none;font-weight:700;margin-bottom:0;margin-top:0;padding-bottom:.4rem;padding-top:.4rem;position:relative}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary){margin-left:-.8rem;margin-right:-.6rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary){margin-left:-.8rem;margin-right:-.6rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){margin-left:-.8rem;margin-right:-.6rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary){margin-left:-.6rem;margin-right:-.8rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary){margin-left:-.6rem;margin-right:-.8rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){margin-left:-.6rem;margin-right:-.8rem}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary){padding-left:2.2rem;padding-right:.6rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary){padding-left:2.2rem;padding-right:.6rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){padding-left:2.2rem;padding-right:.6rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary){padding-left:.6rem;padding-right:2.2rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary){padding-left:.6rem;padding-right:2.2rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){padding-left:.6rem;padding-right:2.2rem}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary){border-left-width:.2rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary){border-left-width:.2rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){border-left-width:.2rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary){border-right-width:.2rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary){border-right-width:.2rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){border-right-width:.2rem}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary){border-top-left-radius:.1rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary){border-top-left-radius:.1rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){border-top-left-radius:.1rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary){border-top-right-radius:.1rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary){border-top-right-radius:.1rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){border-top-right-radius:.1rem}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary){border-top-right-radius:.1rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary){border-top-right-radius:.1rem}[dir=ltr] .md-typeset :is(.admonition-title,summary){border-top-right-radius:.1rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary){border-top-left-radius:.1rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary){border-top-left-radius:.1rem}[dir=rtl] .md-typeset :is(.admonition-title,summary){border-top-left-radius:.1rem}.md-typeset :is(.admonition-title,summary){background-color:rgba(68,138,255,.1);border:none;font-weight:700;margin-bottom:0;margin-top:0;padding-bottom:.4rem;padding-top:.4rem;position:relative}html .md-typeset :-webkit-any(.admonition-title,summary):last-child{margin-bottom:0}html .md-typeset :-moz-any(.admonition-title,summary):last-child{margin-bottom:0}html .md-typeset :is(.admonition-title,summary):last-child{margin-bottom:0}.md-typeset :-webkit-any(.admonition-title,summary):before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset :-moz-any(.admonition-title,summary):before{background-color:#448aff;content:"";height:1rem;mask-image:var(--md-admonition-icon--note);mask-position:center;mask-repeat:no-repeat;mask-size:contain;position:absolute;top:.625em;width:1rem}[dir=ltr] .md-typeset :-webkit-any(.admonition-title,summary):before{left:.8rem}[dir=ltr] .md-typeset :-moz-any(.admonition-title,summary):before{left:.8rem}[dir=ltr] .md-typeset :is(.admonition-title,summary):before{left:.8rem}[dir=rtl] .md-typeset :-webkit-any(.admonition-title,summary):before{right:.8rem}[dir=rtl] .md-typeset :-moz-any(.admonition-title,summary):before{right:.8rem}[dir=rtl] .md-typeset :is(.admonition-title,summary):before{right:.8rem}.md-typeset :is(.admonition-title,summary):before{background-color:#448aff;content:"";height:1rem;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;width:1rem}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.note){border-color:#448aff}.md-typeset :-moz-any(.admonition,details):-moz-any(.note){border-color:#448aff}.md-typeset :is(.admonition,details):is(.note){border-color:#448aff}.md-typeset :-webkit-any(.note)>:-webkit-any(.admonition-title,summary){background-color:rgba(68,138,255,.1)}.md-typeset :-moz-any(.note)>:-moz-any(.admonition-title,summary){background-color:rgba(68,138,255,.1)}.md-typeset :is(.note)>:is(.admonition-title,summary){background-color:rgba(68,138,255,.1)}.md-typeset :-webkit-any(.note)>:-webkit-any(.admonition-title,summary):before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset :-moz-any(.note)>:-moz-any(.admonition-title,summary):before{background-color:#448aff;mask-image:var(--md-admonition-icon--note)}.md-typeset :is(.note)>:is(.admonition-title,summary):before{background-color:#448aff;-webkit-mask-image:var(--md-admonition-icon--note);mask-image:var(--md-admonition-icon--note)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.abstract,.summary,.tldr){border-color:#00b0ff}.md-typeset :-moz-any(.admonition,details):-moz-any(.abstract,.summary,.tldr){border-color:#00b0ff}.md-typeset :is(.admonition,details):is(.abstract,.summary,.tldr){border-color:#00b0ff}.md-typeset :-webkit-any(.abstract,.summary,.tldr)>:-webkit-any(.admonition-title,summary){background-color:rgba(0,176,255,.1)}.md-typeset :-moz-any(.abstract,.summary,.tldr)>:-moz-any(.admonition-title,summary){background-color:rgba(0,176,255,.1)}.md-typeset :is(.abstract,.summary,.tldr)>:is(.admonition-title,summary){background-color:rgba(0,176,255,.1)}.md-typeset :-webkit-any(.abstract,.summary,.tldr)>:-webkit-any(.admonition-title,summary):before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset :-moz-any(.abstract,.summary,.tldr)>:-moz-any(.admonition-title,summary):before{background-color:#00b0ff;mask-image:var(--md-admonition-icon--abstract)}.md-typeset :is(.abstract,.summary,.tldr)>:is(.admonition-title,summary):before{background-color:#00b0ff;-webkit-mask-image:var(--md-admonition-icon--abstract);mask-image:var(--md-admonition-icon--abstract)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.info,.todo){border-color:#00b8d4}.md-typeset :-moz-any(.admonition,details):-moz-any(.info,.todo){border-color:#00b8d4}.md-typeset :is(.admonition,details):is(.info,.todo){border-color:#00b8d4}.md-typeset :-webkit-any(.info,.todo)>:-webkit-any(.admonition-title,summary){background-color:rgba(0,184,212,.1)}.md-typeset :-moz-any(.info,.todo)>:-moz-any(.admonition-title,summary){background-color:rgba(0,184,212,.1)}.md-typeset :is(.info,.todo)>:is(.admonition-title,summary){background-color:rgba(0,184,212,.1)}.md-typeset :-webkit-any(.info,.todo)>:-webkit-any(.admonition-title,summary):before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset :-moz-any(.info,.todo)>:-moz-any(.admonition-title,summary):before{background-color:#00b8d4;mask-image:var(--md-admonition-icon--info)}.md-typeset :is(.info,.todo)>:is(.admonition-title,summary):before{background-color:#00b8d4;-webkit-mask-image:var(--md-admonition-icon--info);mask-image:var(--md-admonition-icon--info)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.tip,.hint,.important){border-color:#00bfa5}.md-typeset :-moz-any(.admonition,details):-moz-any(.tip,.hint,.important){border-color:#00bfa5}.md-typeset :is(.admonition,details):is(.tip,.hint,.important){border-color:#00bfa5}.md-typeset :-webkit-any(.tip,.hint,.important)>:-webkit-any(.admonition-title,summary){background-color:rgba(0,191,165,.1)}.md-typeset :-moz-any(.tip,.hint,.important)>:-moz-any(.admonition-title,summary){background-color:rgba(0,191,165,.1)}.md-typeset :is(.tip,.hint,.important)>:is(.admonition-title,summary){background-color:rgba(0,191,165,.1)}.md-typeset :-webkit-any(.tip,.hint,.important)>:-webkit-any(.admonition-title,summary):before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset :-moz-any(.tip,.hint,.important)>:-moz-any(.admonition-title,summary):before{background-color:#00bfa5;mask-image:var(--md-admonition-icon--tip)}.md-typeset :is(.tip,.hint,.important)>:is(.admonition-title,summary):before{background-color:#00bfa5;-webkit-mask-image:var(--md-admonition-icon--tip);mask-image:var(--md-admonition-icon--tip)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.success,.check,.done){border-color:#00c853}.md-typeset :-moz-any(.admonition,details):-moz-any(.success,.check,.done){border-color:#00c853}.md-typeset :is(.admonition,details):is(.success,.check,.done){border-color:#00c853}.md-typeset :-webkit-any(.success,.check,.done)>:-webkit-any(.admonition-title,summary){background-color:rgba(0,200,83,.1)}.md-typeset :-moz-any(.success,.check,.done)>:-moz-any(.admonition-title,summary){background-color:rgba(0,200,83,.1)}.md-typeset :is(.success,.check,.done)>:is(.admonition-title,summary){background-color:rgba(0,200,83,.1)}.md-typeset :-webkit-any(.success,.check,.done)>:-webkit-any(.admonition-title,summary):before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset :-moz-any(.success,.check,.done)>:-moz-any(.admonition-title,summary):before{background-color:#00c853;mask-image:var(--md-admonition-icon--success)}.md-typeset :is(.success,.check,.done)>:is(.admonition-title,summary):before{background-color:#00c853;-webkit-mask-image:var(--md-admonition-icon--success);mask-image:var(--md-admonition-icon--success)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.question,.help,.faq){border-color:#64dd17}.md-typeset :-moz-any(.admonition,details):-moz-any(.question,.help,.faq){border-color:#64dd17}.md-typeset :is(.admonition,details):is(.question,.help,.faq){border-color:#64dd17}.md-typeset :-webkit-any(.question,.help,.faq)>:-webkit-any(.admonition-title,summary){background-color:rgba(100,221,23,.1)}.md-typeset :-moz-any(.question,.help,.faq)>:-moz-any(.admonition-title,summary){background-color:rgba(100,221,23,.1)}.md-typeset :is(.question,.help,.faq)>:is(.admonition-title,summary){background-color:rgba(100,221,23,.1)}.md-typeset :-webkit-any(.question,.help,.faq)>:-webkit-any(.admonition-title,summary):before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset :-moz-any(.question,.help,.faq)>:-moz-any(.admonition-title,summary):before{background-color:#64dd17;mask-image:var(--md-admonition-icon--question)}.md-typeset :is(.question,.help,.faq)>:is(.admonition-title,summary):before{background-color:#64dd17;-webkit-mask-image:var(--md-admonition-icon--question);mask-image:var(--md-admonition-icon--question)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.warning,.caution,.attention){border-color:#ff9100}.md-typeset :-moz-any(.admonition,details):-moz-any(.warning,.caution,.attention){border-color:#ff9100}.md-typeset :is(.admonition,details):is(.warning,.caution,.attention){border-color:#ff9100}.md-typeset :-webkit-any(.warning,.caution,.attention)>:-webkit-any(.admonition-title,summary){background-color:rgba(255,145,0,.1)}.md-typeset :-moz-any(.warning,.caution,.attention)>:-moz-any(.admonition-title,summary){background-color:rgba(255,145,0,.1)}.md-typeset :is(.warning,.caution,.attention)>:is(.admonition-title,summary){background-color:rgba(255,145,0,.1)}.md-typeset :-webkit-any(.warning,.caution,.attention)>:-webkit-any(.admonition-title,summary):before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset :-moz-any(.warning,.caution,.attention)>:-moz-any(.admonition-title,summary):before{background-color:#ff9100;mask-image:var(--md-admonition-icon--warning)}.md-typeset :is(.warning,.caution,.attention)>:is(.admonition-title,summary):before{background-color:#ff9100;-webkit-mask-image:var(--md-admonition-icon--warning);mask-image:var(--md-admonition-icon--warning)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.failure,.fail,.missing){border-color:#ff5252}.md-typeset :-moz-any(.admonition,details):-moz-any(.failure,.fail,.missing){border-color:#ff5252}.md-typeset :is(.admonition,details):is(.failure,.fail,.missing){border-color:#ff5252}.md-typeset :-webkit-any(.failure,.fail,.missing)>:-webkit-any(.admonition-title,summary){background-color:rgba(255,82,82,.1)}.md-typeset :-moz-any(.failure,.fail,.missing)>:-moz-any(.admonition-title,summary){background-color:rgba(255,82,82,.1)}.md-typeset :is(.failure,.fail,.missing)>:is(.admonition-title,summary){background-color:rgba(255,82,82,.1)}.md-typeset :-webkit-any(.failure,.fail,.missing)>:-webkit-any(.admonition-title,summary):before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset :-moz-any(.failure,.fail,.missing)>:-moz-any(.admonition-title,summary):before{background-color:#ff5252;mask-image:var(--md-admonition-icon--failure)}.md-typeset :is(.failure,.fail,.missing)>:is(.admonition-title,summary):before{background-color:#ff5252;-webkit-mask-image:var(--md-admonition-icon--failure);mask-image:var(--md-admonition-icon--failure)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.danger,.error){border-color:#ff1744}.md-typeset :-moz-any(.admonition,details):-moz-any(.danger,.error){border-color:#ff1744}.md-typeset :is(.admonition,details):is(.danger,.error){border-color:#ff1744}.md-typeset :-webkit-any(.danger,.error)>:-webkit-any(.admonition-title,summary){background-color:rgba(255,23,68,.1)}.md-typeset :-moz-any(.danger,.error)>:-moz-any(.admonition-title,summary){background-color:rgba(255,23,68,.1)}.md-typeset :is(.danger,.error)>:is(.admonition-title,summary){background-color:rgba(255,23,68,.1)}.md-typeset :-webkit-any(.danger,.error)>:-webkit-any(.admonition-title,summary):before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset :-moz-any(.danger,.error)>:-moz-any(.admonition-title,summary):before{background-color:#ff1744;mask-image:var(--md-admonition-icon--danger)}.md-typeset :is(.danger,.error)>:is(.admonition-title,summary):before{background-color:#ff1744;-webkit-mask-image:var(--md-admonition-icon--danger);mask-image:var(--md-admonition-icon--danger)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.bug){border-color:#f50057}.md-typeset :-moz-any(.admonition,details):-moz-any(.bug){border-color:#f50057}.md-typeset :is(.admonition,details):is(.bug){border-color:#f50057}.md-typeset :-webkit-any(.bug)>:-webkit-any(.admonition-title,summary){background-color:rgba(245,0,87,.1)}.md-typeset :-moz-any(.bug)>:-moz-any(.admonition-title,summary){background-color:rgba(245,0,87,.1)}.md-typeset :is(.bug)>:is(.admonition-title,summary){background-color:rgba(245,0,87,.1)}.md-typeset :-webkit-any(.bug)>:-webkit-any(.admonition-title,summary):before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset :-moz-any(.bug)>:-moz-any(.admonition-title,summary):before{background-color:#f50057;mask-image:var(--md-admonition-icon--bug)}.md-typeset :is(.bug)>:is(.admonition-title,summary):before{background-color:#f50057;-webkit-mask-image:var(--md-admonition-icon--bug);mask-image:var(--md-admonition-icon--bug)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.example){border-color:#7c4dff}.md-typeset :-moz-any(.admonition,details):-moz-any(.example){border-color:#7c4dff}.md-typeset :is(.admonition,details):is(.example){border-color:#7c4dff}.md-typeset :-webkit-any(.example)>:-webkit-any(.admonition-title,summary){background-color:rgba(124,77,255,.1)}.md-typeset :-moz-any(.example)>:-moz-any(.admonition-title,summary){background-color:rgba(124,77,255,.1)}.md-typeset :is(.example)>:is(.admonition-title,summary){background-color:rgba(124,77,255,.1)}.md-typeset :-webkit-any(.example)>:-webkit-any(.admonition-title,summary):before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset :-moz-any(.example)>:-moz-any(.admonition-title,summary):before{background-color:#7c4dff;mask-image:var(--md-admonition-icon--example)}.md-typeset :is(.example)>:is(.admonition-title,summary):before{background-color:#7c4dff;-webkit-mask-image:var(--md-admonition-icon--example);mask-image:var(--md-admonition-icon--example)}.md-typeset :-webkit-any(.admonition,details):-webkit-any(.quote,.cite){border-color:#9e9e9e}.md-typeset :-moz-any(.admonition,details):-moz-any(.quote,.cite){border-color:#9e9e9e}.md-typeset :is(.admonition,details):is(.quote,.cite){border-color:#9e9e9e}.md-typeset :-webkit-any(.quote,.cite)>:-webkit-any(.admonition-title,summary){background-color:hsla(0,0%,62%,.1)}.md-typeset :-moz-any(.quote,.cite)>:-moz-any(.admonition-title,summary){background-color:hsla(0,0%,62%,.1)}.md-typeset :is(.quote,.cite)>:is(.admonition-title,summary){background-color:hsla(0,0%,62%,.1)}.md-typeset :-webkit-any(.quote,.cite)>:-webkit-any(.admonition-title,summary):before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}.md-typeset :-moz-any(.quote,.cite)>:-moz-any(.admonition-title,summary):before{background-color:#9e9e9e;mask-image:var(--md-admonition-icon--quote)}.md-typeset :is(.quote,.cite)>:is(.admonition-title,summary):before{background-color:#9e9e9e;-webkit-mask-image:var(--md-admonition-icon--quote);mask-image:var(--md-admonition-icon--quote)}:root{--md-footnotes-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .footnote{color:var(--md-default-fg-color--light);font-size:.64rem}[dir=ltr] .md-typeset .footnote>ol{margin-left:0}[dir=rtl] .md-typeset .footnote>ol{margin-right:0}.md-typeset .footnote>ol>li{transition:color 125ms}.md-typeset .footnote>ol>li:target{color:var(--md-default-fg-color)}.md-typeset .footnote>ol>li:focus-within .footnote-backref{opacity:1;transform:translateX(0);transition:none}.md-typeset .footnote>ol>li:-webkit-any(:hover,:target) .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li:-moz-any(:hover,:target) .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li:is(:hover,:target) .footnote-backref{opacity:1;transform:translateX(0)}.md-typeset .footnote>ol>li>:first-child{margin-top:0}.md-typeset .footnote-ref{font-size:.75em;font-weight:700}html .md-typeset .footnote-ref{outline-offset:.1rem}.md-typeset [id^="fnref:"]:target>.footnote-ref{outline:auto}.md-typeset .footnote-backref{color:var(--md-typeset-a-color);display:inline-block;font-size:0;opacity:0;transform:translateX(.25rem);transition:color .25s,transform .25s .25s,opacity 125ms .25s;vertical-align:text-bottom}@media print{.md-typeset .footnote-backref{color:var(--md-typeset-a-color);opacity:1;transform:translateX(0)}}[dir=rtl] .md-typeset .footnote-backref{transform:translateX(-.25rem)}.md-typeset .footnote-backref:hover{color:var(--md-accent-fg-color)}.md-typeset .footnote-backref:before{background-color:currentcolor;content:"";display:inline-block;height:.8rem;-webkit-mask-image:var(--md-footnotes-icon);mask-image:var(--md-footnotes-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;width:.8rem}[dir=rtl] .md-typeset .footnote-backref:before svg{transform:scaleX(-1)}[dir=ltr] .md-typeset .headerlink{margin-left:.5rem}[dir=rtl] .md-typeset .headerlink{margin-right:.5rem}.md-typeset .headerlink{color:var(--md-default-fg-color--lighter);display:inline-block;opacity:0;transition:color .25s,opacity 125ms}@media print{.md-typeset .headerlink{display:none}}.md-typeset .headerlink:focus,.md-typeset :-webkit-any(:hover,:target)>.headerlink{opacity:1;-webkit-transition:color .25s,opacity 125ms;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset :-moz-any(:hover,:target)>.headerlink{opacity:1;-moz-transition:color .25s,opacity 125ms;transition:color .25s,opacity 125ms}.md-typeset .headerlink:focus,.md-typeset :is(:hover,:target)>.headerlink{opacity:1;transition:color .25s,opacity 125ms}.md-typeset .headerlink:-webkit-any(:focus,:hover),.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset .headerlink:-moz-any(:focus,:hover),.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset .headerlink:is(:focus,:hover),.md-typeset :target>.headerlink{color:var(--md-accent-fg-color)}.md-typeset :target{--md-scroll-margin:3.6rem;--md-scroll-offset:0rem;scroll-margin-top:calc(var(--md-scroll-margin) - var(--md-scroll-offset))}@media screen and (min-width:76.25em){.md-header--lifted~.md-container .md-typeset :target{--md-scroll-margin:6rem}}.md-typeset :-webkit-any(h1,h2,h3):target{--md-scroll-offset:0.2rem}.md-typeset :-moz-any(h1,h2,h3):target{--md-scroll-offset:0.2rem}.md-typeset :is(h1,h2,h3):target{--md-scroll-offset:0.2rem}.md-typeset h4:target{--md-scroll-offset:0.15rem}.md-typeset div.arithmatex{overflow:auto}@media screen and (max-width:44.9375em){.md-typeset div.arithmatex{margin:0 -.8rem}}.md-typeset div.arithmatex>*{margin-left:auto!important;margin-right:auto!important;padding:0 .8rem;touch-action:auto;width:-webkit-min-content;width:-moz-min-content;width:min-content}.md-typeset div.arithmatex>* mjx-container{margin:0!important}.md-typeset :-webkit-any(del,ins,.comment).critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset :-moz-any(del,ins,.comment).critic{box-decoration-break:clone}.md-typeset :is(del,ins,.comment).critic{-webkit-box-decoration-break:clone;box-decoration-break:clone}.md-typeset del.critic{background-color:var(--md-typeset-del-color)}.md-typeset ins.critic{background-color:var(--md-typeset-ins-color)}.md-typeset .critic.comment{color:var(--md-code-hl-comment-color)}.md-typeset .critic.comment:before{content:"/* "}.md-typeset .critic.comment:after{content:" */"}.md-typeset .critic.block{box-shadow:none;display:block;margin:1em 0;overflow:auto;padding-left:.8rem;padding-right:.8rem}.md-typeset .critic.block>:first-child{margin-top:.5em}.md-typeset .critic.block>:last-child{margin-bottom:.5em}:root{--md-details-icon:url('data:image/svg+xml;charset=utf-8,')}.md-typeset details{display:flow-root;overflow:visible;padding-top:0}.md-typeset details[open]>summary:after{transform:rotate(90deg)}.md-typeset details:not([open]){box-shadow:none;padding-bottom:0}.md-typeset details:not([open])>summary{border-radius:.1rem}[dir=ltr] .md-typeset summary{padding-right:1.8rem}[dir=rtl] .md-typeset summary{padding-left:1.8rem}[dir=ltr] .md-typeset summary{border-top-left-radius:.1rem}[dir=ltr] .md-typeset summary,[dir=rtl] .md-typeset summary{border-top-right-radius:.1rem}[dir=rtl] .md-typeset summary{border-top-left-radius:.1rem}.md-typeset summary{cursor:pointer;display:block;min-height:1rem}.md-typeset summary.focus-visible{outline-color:var(--md-accent-fg-color);outline-offset:.2rem}.md-typeset summary:not(.focus-visible){-webkit-tap-highlight-color:transparent;outline:none}[dir=ltr] .md-typeset summary:after{right:.4rem}[dir=rtl] .md-typeset summary:after{left:.4rem}.md-typeset summary:after{background-color:currentcolor;content:"";height:1rem;-webkit-mask-image:var(--md-details-icon);mask-image:var(--md-details-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.625em;transform:rotate(0deg);transition:transform .25s;width:1rem}[dir=rtl] .md-typeset summary:after{transform:rotate(180deg)}.md-typeset summary::marker{display:none}.md-typeset summary::-webkit-details-marker{display:none}.md-typeset :-webkit-any(.emojione,.twemoji,.gemoji){display:inline-flex;height:1.125em;vertical-align:text-top}.md-typeset :-moz-any(.emojione,.twemoji,.gemoji){display:inline-flex;height:1.125em;vertical-align:text-top}.md-typeset :is(.emojione,.twemoji,.gemoji){display:inline-flex;height:1.125em;vertical-align:text-top}.md-typeset :-webkit-any(.emojione,.twemoji,.gemoji) svg{fill:currentcolor;max-height:100%;width:1.125em}.md-typeset :-moz-any(.emojione,.twemoji,.gemoji) svg{fill:currentcolor;max-height:100%;width:1.125em}.md-typeset :is(.emojione,.twemoji,.gemoji) svg{fill:currentcolor;max-height:100%;width:1.125em}.highlight :-webkit-any(.o,.ow){color:var(--md-code-hl-operator-color)}.highlight :-moz-any(.o,.ow){color:var(--md-code-hl-operator-color)}.highlight :is(.o,.ow){color:var(--md-code-hl-operator-color)}.highlight .p{color:var(--md-code-hl-punctuation-color)}.highlight :-webkit-any(.cpf,.l,.s,.sb,.sc,.s2,.si,.s1,.ss){color:var(--md-code-hl-string-color)}.highlight :-moz-any(.cpf,.l,.s,.sb,.sc,.s2,.si,.s1,.ss){color:var(--md-code-hl-string-color)}.highlight :is(.cpf,.l,.s,.sb,.sc,.s2,.si,.s1,.ss){color:var(--md-code-hl-string-color)}.highlight :-webkit-any(.cp,.se,.sh,.sr,.sx){color:var(--md-code-hl-special-color)}.highlight :-moz-any(.cp,.se,.sh,.sr,.sx){color:var(--md-code-hl-special-color)}.highlight :is(.cp,.se,.sh,.sr,.sx){color:var(--md-code-hl-special-color)}.highlight :-webkit-any(.m,.mb,.mf,.mh,.mi,.il,.mo){color:var(--md-code-hl-number-color)}.highlight :-moz-any(.m,.mb,.mf,.mh,.mi,.il,.mo){color:var(--md-code-hl-number-color)}.highlight :is(.m,.mb,.mf,.mh,.mi,.il,.mo){color:var(--md-code-hl-number-color)}.highlight :-webkit-any(.k,.kd,.kn,.kp,.kr,.kt){color:var(--md-code-hl-keyword-color)}.highlight :-moz-any(.k,.kd,.kn,.kp,.kr,.kt){color:var(--md-code-hl-keyword-color)}.highlight :is(.k,.kd,.kn,.kp,.kr,.kt){color:var(--md-code-hl-keyword-color)}.highlight :-webkit-any(.kc,.n){color:var(--md-code-hl-name-color)}.highlight :-moz-any(.kc,.n){color:var(--md-code-hl-name-color)}.highlight :is(.kc,.n){color:var(--md-code-hl-name-color)}.highlight :-webkit-any(.no,.nb,.bp){color:var(--md-code-hl-constant-color)}.highlight :-moz-any(.no,.nb,.bp){color:var(--md-code-hl-constant-color)}.highlight :is(.no,.nb,.bp){color:var(--md-code-hl-constant-color)}.highlight :-webkit-any(.nc,.ne,.nf,.nn){color:var(--md-code-hl-function-color)}.highlight :-moz-any(.nc,.ne,.nf,.nn){color:var(--md-code-hl-function-color)}.highlight :is(.nc,.ne,.nf,.nn){color:var(--md-code-hl-function-color)}.highlight :-webkit-any(.nd,.ni,.nl,.nt){color:var(--md-code-hl-keyword-color)}.highlight :-moz-any(.nd,.ni,.nl,.nt){color:var(--md-code-hl-keyword-color)}.highlight :is(.nd,.ni,.nl,.nt){color:var(--md-code-hl-keyword-color)}.highlight :-webkit-any(.c,.cm,.c1,.ch,.cs,.sd){color:var(--md-code-hl-comment-color)}.highlight :-moz-any(.c,.cm,.c1,.ch,.cs,.sd){color:var(--md-code-hl-comment-color)}.highlight :is(.c,.cm,.c1,.ch,.cs,.sd){color:var(--md-code-hl-comment-color)}.highlight :-webkit-any(.na,.nv,.vc,.vg,.vi){color:var(--md-code-hl-variable-color)}.highlight :-moz-any(.na,.nv,.vc,.vg,.vi){color:var(--md-code-hl-variable-color)}.highlight :is(.na,.nv,.vc,.vg,.vi){color:var(--md-code-hl-variable-color)}.highlight :-webkit-any(.ge,.gr,.gh,.go,.gp,.gs,.gu,.gt){color:var(--md-code-hl-generic-color)}.highlight :-moz-any(.ge,.gr,.gh,.go,.gp,.gs,.gu,.gt){color:var(--md-code-hl-generic-color)}.highlight :is(.ge,.gr,.gh,.go,.gp,.gs,.gu,.gt){color:var(--md-code-hl-generic-color)}.highlight :-webkit-any(.gd,.gi){border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight :-moz-any(.gd,.gi){border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight :is(.gd,.gi){border-radius:.1rem;margin:0 -.125em;padding:0 .125em}.highlight .gd{background-color:var(--md-typeset-del-color)}.highlight .gi{background-color:var(--md-typeset-ins-color)}.highlight .hll{background-color:var(--md-code-hl-color);display:block;margin:0 -1.1764705882em;padding:0 1.1764705882em}.highlight span.filename{background-color:var(--md-code-bg-color);border-bottom:.05rem solid var(--md-default-fg-color--lightest);border-top-left-radius:.1rem;border-top-right-radius:.1rem;display:flow-root;font-size:.85em;font-weight:700;margin-top:1em;padding:.6617647059em 1.1764705882em;position:relative}.highlight span.filename+pre{margin-top:0}.highlight span.filename+pre>code{border-top-left-radius:0;border-top-right-radius:0}.highlight [data-linenos]:before{background-color:var(--md-code-bg-color);box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;color:var(--md-default-fg-color--light);content:attr(data-linenos);float:left;left:-1.1764705882em;margin-left:-1.1764705882em;margin-right:1.1764705882em;padding-left:1.1764705882em;position:-webkit-sticky;position:sticky;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;z-index:3}.highlight code a[id]{position:absolute;visibility:hidden}.highlight code[data-md-copying] .hll{display:contents}.highlight code[data-md-copying] .md-annotation{display:none}.highlighttable{display:flow-root}.highlighttable :-webkit-any(tbody,td){display:block;padding:0}.highlighttable :-moz-any(tbody,td){display:block;padding:0}.highlighttable :is(tbody,td){display:block;padding:0}.highlighttable tr{display:flex}.highlighttable pre{margin:0}.highlighttable th.filename{flex-grow:1;padding:0;text-align:left}.highlighttable th.filename span.filename{margin-top:0}.highlighttable .linenos{background-color:var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-top-left-radius:.1rem;font-size:.85em;padding:.7720588235em 0 .7720588235em 1.1764705882em;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none}.highlighttable .linenodiv{box-shadow:-.05rem 0 var(--md-default-fg-color--lightest) inset;padding-right:.5882352941em}.highlighttable .linenodiv pre{color:var(--md-default-fg-color--light);text-align:right}.highlighttable .code{flex:1;min-width:0}.linenodiv a{color:inherit}.md-typeset .highlighttable{direction:ltr;margin:1em 0}.md-typeset .highlighttable>tbody>tr>.code>div>pre>code{border-bottom-left-radius:0;border-top-left-radius:0}.md-typeset .highlight+.result{border:.05rem solid var(--md-code-bg-color);border-bottom-left-radius:.1rem;border-bottom-right-radius:.1rem;border-top-width:.1rem;margin-top:-1.125em;overflow:visible;padding:0 1em}.md-typeset .highlight+.result:after{clear:both;content:"";display:block}@media screen and (max-width:44.9375em){.md-content__inner>.highlight{margin:1em -.8rem}.md-content__inner>.highlight>.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.code>div>pre>code,.md-content__inner>.highlight>.highlighttable>tbody>tr>.filename span.filename,.md-content__inner>.highlight>.highlighttable>tbody>tr>.linenos,.md-content__inner>.highlight>pre>code{border-radius:0}.md-content__inner>.highlight+.result{border-left-width:0;border-radius:0;border-right-width:0;margin-left:-.8rem;margin-right:-.8rem}}.md-typeset .keys kbd:-webkit-any(:before,:after){-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys kbd:-moz-any(:before,:after){-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys kbd:is(:before,:after){-moz-osx-font-smoothing:initial;-webkit-font-smoothing:initial;color:inherit;margin:0;position:relative}.md-typeset .keys span{color:var(--md-default-fg-color--light);padding:0 .2em}.md-typeset .keys .key-alt:before,.md-typeset .keys .key-left-alt:before,.md-typeset .keys .key-right-alt:before{content:"⎇";padding-right:.4em}.md-typeset .keys .key-command:before,.md-typeset .keys .key-left-command:before,.md-typeset .keys .key-right-command:before{content:"⌘";padding-right:.4em}.md-typeset .keys .key-control:before,.md-typeset .keys .key-left-control:before,.md-typeset .keys .key-right-control:before{content:"⌃";padding-right:.4em}.md-typeset .keys .key-left-meta:before,.md-typeset .keys .key-meta:before,.md-typeset .keys .key-right-meta:before{content:"◆";padding-right:.4em}.md-typeset .keys .key-left-option:before,.md-typeset .keys .key-option:before,.md-typeset .keys .key-right-option:before{content:"⌥";padding-right:.4em}.md-typeset .keys .key-left-shift:before,.md-typeset .keys .key-right-shift:before,.md-typeset .keys .key-shift:before{content:"⇧";padding-right:.4em}.md-typeset .keys .key-left-super:before,.md-typeset .keys .key-right-super:before,.md-typeset .keys .key-super:before{content:"❖";padding-right:.4em}.md-typeset .keys .key-left-windows:before,.md-typeset .keys .key-right-windows:before,.md-typeset .keys .key-windows:before{content:"⊞";padding-right:.4em}.md-typeset .keys .key-arrow-down:before{content:"↓";padding-right:.4em}.md-typeset .keys .key-arrow-left:before{content:"←";padding-right:.4em}.md-typeset .keys .key-arrow-right:before{content:"→";padding-right:.4em}.md-typeset .keys .key-arrow-up:before{content:"↑";padding-right:.4em}.md-typeset .keys .key-backspace:before{content:"⌫";padding-right:.4em}.md-typeset .keys .key-backtab:before{content:"⇤";padding-right:.4em}.md-typeset .keys .key-caps-lock:before{content:"⇪";padding-right:.4em}.md-typeset .keys .key-clear:before{content:"⌧";padding-right:.4em}.md-typeset .keys .key-context-menu:before{content:"☰";padding-right:.4em}.md-typeset .keys .key-delete:before{content:"⌦";padding-right:.4em}.md-typeset .keys .key-eject:before{content:"⏏";padding-right:.4em}.md-typeset .keys .key-end:before{content:"⤓";padding-right:.4em}.md-typeset .keys .key-escape:before{content:"⎋";padding-right:.4em}.md-typeset .keys .key-home:before{content:"⤒";padding-right:.4em}.md-typeset .keys .key-insert:before{content:"⎀";padding-right:.4em}.md-typeset .keys .key-page-down:before{content:"⇟";padding-right:.4em}.md-typeset .keys .key-page-up:before{content:"⇞";padding-right:.4em}.md-typeset .keys .key-print-screen:before{content:"⎙";padding-right:.4em}.md-typeset .keys .key-tab:after{content:"⇥";padding-left:.4em}.md-typeset .keys .key-num-enter:after{content:"⌤";padding-left:.4em}.md-typeset .keys .key-enter:after{content:"⏎";padding-left:.4em}:root{--md-tabbed-icon--prev:url('data:image/svg+xml;charset=utf-8,');--md-tabbed-icon--next:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .tabbed-set{border-radius:.1rem;display:flex;flex-flow:column wrap;margin:1em 0;position:relative}.md-typeset .tabbed-set>input{height:0;opacity:0;position:absolute;width:0}.md-typeset .tabbed-set>input:target{--md-scroll-offset:0.625em}.md-typeset .tabbed-labels{-ms-overflow-style:none;box-shadow:0 -.05rem var(--md-default-fg-color--lightest) inset;display:flex;max-width:100%;overflow:auto;scrollbar-width:none}@media print{.md-typeset .tabbed-labels{display:contents}}@media screen{.js .md-typeset .tabbed-labels{position:relative}.js .md-typeset .tabbed-labels:before{background:var(--md-accent-fg-color);bottom:0;content:"";display:block;height:2px;left:0;position:absolute;transform:translateX(var(--md-indicator-x));transition:width 225ms,transform .25s;transition-timing-function:cubic-bezier(.4,0,.2,1);width:var(--md-indicator-width)}}.md-typeset .tabbed-labels::-webkit-scrollbar{display:none}.md-typeset .tabbed-labels>label{border-bottom:.1rem solid transparent;border-radius:.1rem .1rem 0 0;color:var(--md-default-fg-color--light);cursor:pointer;flex-shrink:0;font-size:.64rem;font-weight:700;padding:.78125em 1.25em .625em;scroll-margin-inline-start:1rem;transition:background-color .25s,color .25s;white-space:nowrap;width:auto}@media print{.md-typeset .tabbed-labels>label:first-child{order:1}.md-typeset .tabbed-labels>label:nth-child(2){order:2}.md-typeset .tabbed-labels>label:nth-child(3){order:3}.md-typeset .tabbed-labels>label:nth-child(4){order:4}.md-typeset .tabbed-labels>label:nth-child(5){order:5}.md-typeset .tabbed-labels>label:nth-child(6){order:6}.md-typeset .tabbed-labels>label:nth-child(7){order:7}.md-typeset .tabbed-labels>label:nth-child(8){order:8}.md-typeset .tabbed-labels>label:nth-child(9){order:9}.md-typeset .tabbed-labels>label:nth-child(10){order:10}.md-typeset .tabbed-labels>label:nth-child(11){order:11}.md-typeset .tabbed-labels>label:nth-child(12){order:12}.md-typeset .tabbed-labels>label:nth-child(13){order:13}.md-typeset .tabbed-labels>label:nth-child(14){order:14}.md-typeset .tabbed-labels>label:nth-child(15){order:15}.md-typeset .tabbed-labels>label:nth-child(16){order:16}.md-typeset .tabbed-labels>label:nth-child(17){order:17}.md-typeset .tabbed-labels>label:nth-child(18){order:18}.md-typeset .tabbed-labels>label:nth-child(19){order:19}.md-typeset .tabbed-labels>label:nth-child(20){order:20}}.md-typeset .tabbed-labels>label:hover{color:var(--md-accent-fg-color)}.md-typeset .tabbed-content{width:100%}@media print{.md-typeset .tabbed-content{display:contents}}.md-typeset .tabbed-block{display:none}@media print{.md-typeset .tabbed-block{display:block}.md-typeset .tabbed-block:first-child{order:1}.md-typeset .tabbed-block:nth-child(2){order:2}.md-typeset .tabbed-block:nth-child(3){order:3}.md-typeset .tabbed-block:nth-child(4){order:4}.md-typeset .tabbed-block:nth-child(5){order:5}.md-typeset .tabbed-block:nth-child(6){order:6}.md-typeset .tabbed-block:nth-child(7){order:7}.md-typeset .tabbed-block:nth-child(8){order:8}.md-typeset .tabbed-block:nth-child(9){order:9}.md-typeset .tabbed-block:nth-child(10){order:10}.md-typeset .tabbed-block:nth-child(11){order:11}.md-typeset .tabbed-block:nth-child(12){order:12}.md-typeset .tabbed-block:nth-child(13){order:13}.md-typeset .tabbed-block:nth-child(14){order:14}.md-typeset .tabbed-block:nth-child(15){order:15}.md-typeset .tabbed-block:nth-child(16){order:16}.md-typeset .tabbed-block:nth-child(17){order:17}.md-typeset .tabbed-block:nth-child(18){order:18}.md-typeset .tabbed-block:nth-child(19){order:19}.md-typeset .tabbed-block:nth-child(20){order:20}}.md-typeset .tabbed-block>.highlight:first-child>pre,.md-typeset .tabbed-block>pre:first-child{margin:0}.md-typeset .tabbed-block>.highlight:first-child>pre>code,.md-typeset .tabbed-block>pre:first-child>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child>.filename{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable{margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.filename span.filename,.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.linenos{border-top-left-radius:0;border-top-right-radius:0;margin:0}.md-typeset .tabbed-block>.highlight:first-child>.highlighttable>tbody>tr>.code>div>pre>code{border-top-left-radius:0;border-top-right-radius:0}.md-typeset .tabbed-block>.highlight:first-child+.result{margin-top:-.125em}.md-typeset .tabbed-block>.tabbed-set{margin:0}.md-typeset .tabbed-button{align-self:center;border-radius:100%;color:var(--md-default-fg-color--light);cursor:pointer;display:block;height:.9rem;margin-top:.1rem;pointer-events:auto;transition:background-color .25s;width:.9rem}.md-typeset .tabbed-button:hover{background-color:var(--md-accent-fg-color--transparent);color:var(--md-accent-fg-color)}.md-typeset .tabbed-button:after{background-color:currentcolor;content:"";display:block;height:100%;-webkit-mask-image:var(--md-tabbed-icon--prev);mask-image:var(--md-tabbed-icon--prev);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;transition:background-color .25s,transform .25s;width:100%}.md-typeset .tabbed-control{background:linear-gradient(to right,var(--md-default-bg-color) 60%,transparent);display:flex;height:1.9rem;justify-content:start;pointer-events:none;position:absolute;transition:opacity 125ms;width:1.2rem}[dir=rtl] .md-typeset .tabbed-control{transform:rotate(180deg)}.md-typeset .tabbed-control[hidden]{opacity:0}.md-typeset .tabbed-control--next{background:linear-gradient(to left,var(--md-default-bg-color) 60%,transparent);justify-content:end;right:0}.md-typeset .tabbed-control--next .tabbed-button:after{-webkit-mask-image:var(--md-tabbed-icon--next);mask-image:var(--md-tabbed-icon--next)}@media screen and (max-width:44.9375em){[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels{margin:0 -.8rem;max-width:100vw;scroll-padding-inline-start:.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels:after{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels:after{content:""}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-left:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{margin-right:-.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-left:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{padding-right:.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--prev{width:2rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-right:-.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{margin-left:-.8rem}[dir=ltr] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-right:.8rem}[dir=rtl] .md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{padding-left:.8rem}.md-content__inner>.tabbed-set .tabbed-labels~.tabbed-control--next{width:2rem}}@media screen{.md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){color:var(--md-accent-fg-color)}.md-typeset .no-js .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.md-typeset .no-js .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.md-typeset .no-js .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.md-typeset .no-js .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.md-typeset .no-js .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.md-typeset .no-js .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.md-typeset .no-js .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.md-typeset .no-js .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.md-typeset .no-js .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.md-typeset .no-js .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.md-typeset .no-js .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.md-typeset .no-js .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.md-typeset .no-js .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.md-typeset .no-js .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.md-typeset .no-js .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.md-typeset .no-js .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.md-typeset .no-js .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.md-typeset .no-js .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.md-typeset .no-js .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.md-typeset .no-js .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9),.no-js .md-typeset .tabbed-set>input:first-child:checked~.tabbed-labels>:first-child,.no-js .md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-labels>:nth-child(10),.no-js .md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-labels>:nth-child(11),.no-js .md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-labels>:nth-child(12),.no-js .md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-labels>:nth-child(13),.no-js .md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-labels>:nth-child(14),.no-js .md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-labels>:nth-child(15),.no-js .md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-labels>:nth-child(16),.no-js .md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-labels>:nth-child(17),.no-js .md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-labels>:nth-child(18),.no-js .md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-labels>:nth-child(19),.no-js .md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-labels>:nth-child(2),.no-js .md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-labels>:nth-child(20),.no-js .md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-labels>:nth-child(3),.no-js .md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-labels>:nth-child(4),.no-js .md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-labels>:nth-child(5),.no-js .md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-labels>:nth-child(6),.no-js .md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-labels>:nth-child(7),.no-js .md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-labels>:nth-child(8),.no-js .md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-labels>:nth-child(9){border-color:var(--md-accent-fg-color)}}.md-typeset .tabbed-set>input:first-child.focus-visible~.tabbed-labels>:first-child,.md-typeset .tabbed-set>input:nth-child(10).focus-visible~.tabbed-labels>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11).focus-visible~.tabbed-labels>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12).focus-visible~.tabbed-labels>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13).focus-visible~.tabbed-labels>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14).focus-visible~.tabbed-labels>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15).focus-visible~.tabbed-labels>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16).focus-visible~.tabbed-labels>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17).focus-visible~.tabbed-labels>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18).focus-visible~.tabbed-labels>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19).focus-visible~.tabbed-labels>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2).focus-visible~.tabbed-labels>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20).focus-visible~.tabbed-labels>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3).focus-visible~.tabbed-labels>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4).focus-visible~.tabbed-labels>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5).focus-visible~.tabbed-labels>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6).focus-visible~.tabbed-labels>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7).focus-visible~.tabbed-labels>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8).focus-visible~.tabbed-labels>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9).focus-visible~.tabbed-labels>:nth-child(9){background-color:var(--md-accent-fg-color--transparent)}.md-typeset .tabbed-set>input:first-child:checked~.tabbed-content>:first-child,.md-typeset .tabbed-set>input:nth-child(10):checked~.tabbed-content>:nth-child(10),.md-typeset .tabbed-set>input:nth-child(11):checked~.tabbed-content>:nth-child(11),.md-typeset .tabbed-set>input:nth-child(12):checked~.tabbed-content>:nth-child(12),.md-typeset .tabbed-set>input:nth-child(13):checked~.tabbed-content>:nth-child(13),.md-typeset .tabbed-set>input:nth-child(14):checked~.tabbed-content>:nth-child(14),.md-typeset .tabbed-set>input:nth-child(15):checked~.tabbed-content>:nth-child(15),.md-typeset .tabbed-set>input:nth-child(16):checked~.tabbed-content>:nth-child(16),.md-typeset .tabbed-set>input:nth-child(17):checked~.tabbed-content>:nth-child(17),.md-typeset .tabbed-set>input:nth-child(18):checked~.tabbed-content>:nth-child(18),.md-typeset .tabbed-set>input:nth-child(19):checked~.tabbed-content>:nth-child(19),.md-typeset .tabbed-set>input:nth-child(2):checked~.tabbed-content>:nth-child(2),.md-typeset .tabbed-set>input:nth-child(20):checked~.tabbed-content>:nth-child(20),.md-typeset .tabbed-set>input:nth-child(3):checked~.tabbed-content>:nth-child(3),.md-typeset .tabbed-set>input:nth-child(4):checked~.tabbed-content>:nth-child(4),.md-typeset .tabbed-set>input:nth-child(5):checked~.tabbed-content>:nth-child(5),.md-typeset .tabbed-set>input:nth-child(6):checked~.tabbed-content>:nth-child(6),.md-typeset .tabbed-set>input:nth-child(7):checked~.tabbed-content>:nth-child(7),.md-typeset .tabbed-set>input:nth-child(8):checked~.tabbed-content>:nth-child(8),.md-typeset .tabbed-set>input:nth-child(9):checked~.tabbed-content>:nth-child(9){display:block}:root{--md-tasklist-icon:url('data:image/svg+xml;charset=utf-8,');--md-tasklist-icon--checked:url('data:image/svg+xml;charset=utf-8,')}.md-typeset .task-list-item{list-style-type:none;position:relative}[dir=ltr] .md-typeset .task-list-item [type=checkbox]{left:-2em}[dir=rtl] .md-typeset .task-list-item [type=checkbox]{right:-2em}.md-typeset .task-list-item [type=checkbox]{position:absolute;top:.45em}.md-typeset .task-list-control [type=checkbox]{opacity:0;z-index:-1}[dir=ltr] .md-typeset .task-list-indicator:before{left:-1.5em}[dir=rtl] .md-typeset .task-list-indicator:before{right:-1.5em}.md-typeset .task-list-indicator:before{background-color:var(--md-default-fg-color--lightest);content:"";height:1.25em;-webkit-mask-image:var(--md-tasklist-icon);mask-image:var(--md-tasklist-icon);-webkit-mask-position:center;mask-position:center;-webkit-mask-repeat:no-repeat;mask-repeat:no-repeat;-webkit-mask-size:contain;mask-size:contain;position:absolute;top:.15em;width:1.25em}.md-typeset [type=checkbox]:checked+.task-list-indicator:before{background-color:#00e676;-webkit-mask-image:var(--md-tasklist-icon--checked);mask-image:var(--md-tasklist-icon--checked)}:root>*{--md-mermaid-font-family:var(--md-text-font-family),sans-serif;--md-mermaid-edge-color:var(--md-code-fg-color);--md-mermaid-node-bg-color:var(--md-accent-fg-color--transparent);--md-mermaid-node-fg-color:var(--md-accent-fg-color);--md-mermaid-label-bg-color:var(--md-default-bg-color);--md-mermaid-label-fg-color:var(--md-code-fg-color)}.mermaid{line-height:normal;margin:1em 0}@media screen and (min-width:45em){[dir=ltr] .md-typeset .inline{float:left}[dir=rtl] .md-typeset .inline{float:right}[dir=ltr] .md-typeset .inline{margin-right:.8rem}[dir=rtl] .md-typeset .inline{margin-left:.8rem}.md-typeset .inline{margin-bottom:.8rem;margin-top:0;width:11.7rem}[dir=ltr] .md-typeset .inline.end{float:right}[dir=rtl] .md-typeset .inline.end{float:left}[dir=ltr] .md-typeset .inline.end{margin-left:.8rem;margin-right:0}[dir=rtl] .md-typeset .inline.end{margin-left:0;margin-right:.8rem}} \ No newline at end of file diff --git a/assets/stylesheets/main.80dcb947.min.css.map b/assets/stylesheets/main.80dcb947.min.css.map new file mode 100644 index 00000000..a32399b5 --- /dev/null +++ b/assets/stylesheets/main.80dcb947.min.css.map @@ -0,0 +1 @@ +{"version":3,"sources":["src/assets/stylesheets/main/extensions/pymdownx/_keys.scss","../../../src/assets/stylesheets/main.scss","src/assets/stylesheets/main/_resets.scss","src/assets/stylesheets/main/_colors.scss","src/assets/stylesheets/main/_icons.scss","src/assets/stylesheets/main/_typeset.scss","src/assets/stylesheets/utilities/_break.scss","src/assets/stylesheets/main/layout/_banner.scss","src/assets/stylesheets/main/layout/_base.scss","src/assets/stylesheets/main/layout/_clipboard.scss","src/assets/stylesheets/main/layout/_consent.scss","src/assets/stylesheets/main/layout/_content.scss","src/assets/stylesheets/main/layout/_dialog.scss","src/assets/stylesheets/main/layout/_feedback.scss","src/assets/stylesheets/main/layout/_footer.scss","src/assets/stylesheets/main/layout/_form.scss","src/assets/stylesheets/main/layout/_header.scss","src/assets/stylesheets/main/layout/_nav.scss","src/assets/stylesheets/main/layout/_search.scss","src/assets/stylesheets/main/layout/_select.scss","src/assets/stylesheets/main/layout/_sidebar.scss","src/assets/stylesheets/main/layout/_source.scss","src/assets/stylesheets/main/layout/_tabs.scss","src/assets/stylesheets/main/layout/_tag.scss","src/assets/stylesheets/main/layout/_tooltip.scss","src/assets/stylesheets/main/layout/_top.scss","src/assets/stylesheets/main/layout/_version.scss","src/assets/stylesheets/main/extensions/markdown/_admonition.scss","node_modules/material-design-color/material-color.scss","src/assets/stylesheets/main/extensions/markdown/_footnotes.scss","src/assets/stylesheets/main/extensions/markdown/_toc.scss","src/assets/stylesheets/main/extensions/pymdownx/_arithmatex.scss","src/assets/stylesheets/main/extensions/pymdownx/_critic.scss","src/assets/stylesheets/main/extensions/pymdownx/_details.scss","src/assets/stylesheets/main/extensions/pymdownx/_emoji.scss","src/assets/stylesheets/main/extensions/pymdownx/_highlight.scss","src/assets/stylesheets/main/extensions/pymdownx/_tabbed.scss","src/assets/stylesheets/main/extensions/pymdownx/_tasklist.scss","src/assets/stylesheets/main/integrations/_mermaid.scss","src/assets/stylesheets/main/_modifiers.scss"],"names":[],"mappings":"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yFE,iEACE,oB1BmyFJ,C0BpyFE,2DACE,oB1BmyFJ,C0BpyFE,+CACE,oB1BmyFJ,C0B/xFE,wEACE,oC1BkyFJ,C0BnyFE,kEACE,oC1BkyFJ,C0BnyFE,sDACE,oC1BkyFJ,C0B/xFI,+EACE,wBAnBG,CAoBH,kDAAA,CAAA,0C1BiyFN,C0BnyFI,yEACE,wBAnBG,CAoBH,0C1BiyFN,C0BnyFI,6DACE,wBAnBG,CAoBH,kDAAA,CAAA,0C1BiyFN,C0B5yFE,oFACE,oB1B+yFJ,C0BhzFE,8EACE,oB1B+yFJ,C0BhzFE,kEACE,oB1B+yFJ,C0B3yFE,2FACE,mC1B8yFJ,C0B/yFE,qFACE,mC1B8yFJ,C0B/yFE,yEACE,mC1B8yFJ,C0B3yFI,kGACE,wBAnBG,CAoBH,sDAAA,CAAA,8C1B6yFN,C0B/yFI,4FACE,wBAnBG,CAoBH,8C1B6yFN,C0B/yFI,gFACE,wBAnBG,CAoBH,sDAAA,CAAA,8C1B6yFN,C0BxzFE,uEACE,oB1B2zFJ,C0B5zFE,iEACE,oB1B2zFJ,C0B5zFE,qDACE,oB1B2zFJ,C0BvzFE,8EACE,mC1B0zFJ,C0B3zFE,wEACE,mC1B0zFJ,C0B3zFE,4DACE,mC1B0zFJ,C0BvzFI,qFACE,wBAnBG,CAoBH,kDAAA,CAAA,0C1ByzFN,C0B3zFI,+EACE,wBAnBG,CAoBH,0C1ByzFN,C0B3zFI,mEACE,wBAnBG,CAoBH,kDAAA,CAAA,0C1ByzFN,C0Bp0FE,iFACE,oB1Bu0FJ,C0Bx0FE,2EACE,oB1Bu0FJ,C0Bx0FE,+DACE,oB1Bu0FJ,C0Bn0FE,wFACE,mC1Bs0FJ,C0Bv0FE,kFACE,mC1Bs0FJ,C0Bv0FE,sEACE,mC1Bs0FJ,C0Bn0FI,+FACE,wBAnBG,CAoBH,iDAAA,CAAA,yC1Bq0FN,C0Bv0FI,yFACE,wBAnBG,CAoBH,yC1Bq0FN,C0Bv0FI,6EACE,wBAnBG,CAoBH,iDAAA,CAAA,yC1Bq0FN,C0Bh1FE,iFACE,oB1Bm1FJ,C0Bp1FE,2EACE,oB1Bm1FJ,C0Bp1FE,+DACE,oB1Bm1FJ,C0B/0FE,wFACE,kC1Bk1FJ,C0Bn1FE,kFACE,kC1Bk1FJ,C0Bn1FE,sEACE,kC1Bk1FJ,C0B/0FI,+FACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1Bi1FN,C0Bn1FI,yFACE,wBAnBG,CAoBH,6C1Bi1FN,C0Bn1FI,6EACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1Bi1FN,C0B51FE,gFACE,oB1B+1FJ,C0Bh2FE,0EACE,oB1B+1FJ,C0Bh2FE,8DACE,oB1B+1FJ,C0B31FE,uFACE,oC1B81FJ,C0B/1FE,iFACE,oC1B81FJ,C0B/1FE,qEACE,oC1B81FJ,C0B31FI,8FACE,wBAnBG,CAoBH,sDAAA,CAAA,8C1B61FN,C0B/1FI,wFACE,wBAnBG,CAoBH,8C1B61FN,C0B/1FI,4EACE,wBAnBG,CAoBH,sDAAA,CAAA,8C1B61FN,C0Bx2FE,wFACE,oB1B22FJ,C0B52FE,kFACE,oB1B22FJ,C0B52FE,sEACE,oB1B22FJ,C0Bv2FE,+FACE,mC1B02FJ,C0B32FE,yFACE,mC1B02FJ,C0B32FE,6EACE,mC1B02FJ,C0Bv2FI,sGACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1By2FN,C0B32FI,gGACE,wBAnBG,CAoBH,6C1By2FN,C0B32FI,oFACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1By2FN,C0Bp3FE,mFACE,oB1Bu3FJ,C0Bx3FE,6EACE,oB1Bu3FJ,C0Bx3FE,iEACE,oB1Bu3FJ,C0Bn3FE,0FACE,mC1Bs3FJ,C0Bv3FE,oFACE,mC1Bs3FJ,C0Bv3FE,wEACE,mC1Bs3FJ,C0Bn3FI,iGACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1Bq3FN,C0Bv3FI,2FACE,wBAnBG,CAoBH,6C1Bq3FN,C0Bv3FI,+EACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1Bq3FN,C0Bh4FE,0EACE,oB1Bm4FJ,C0Bp4FE,oEACE,oB1Bm4FJ,C0Bp4FE,wDACE,oB1Bm4FJ,C0B/3FE,iFACE,mC1Bk4FJ,C0Bn4FE,2EACE,mC1Bk4FJ,C0Bn4FE,+DACE,mC1Bk4FJ,C0B/3FI,wFACE,wBAnBG,CAoBH,oDAAA,CAAA,4C1Bi4FN,C0Bn4FI,kFACE,wBAnBG,CAoBH,4C1Bi4FN,C0Bn4FI,sEACE,wBAnBG,CAoBH,oDAAA,CAAA,4C1Bi4FN,C0B54FE,gEACE,oB1B+4FJ,C0Bh5FE,0DACE,oB1B+4FJ,C0Bh5FE,8CACE,oB1B+4FJ,C0B34FE,uEACE,kC1B84FJ,C0B/4FE,iEACE,kC1B84FJ,C0B/4FE,qDACE,kC1B84FJ,C0B34FI,8EACE,wBAnBG,CAoBH,iDAAA,CAAA,yC1B64FN,C0B/4FI,wEACE,wBAnBG,CAoBH,yC1B64FN,C0B/4FI,4DACE,wBAnBG,CAoBH,iDAAA,CAAA,yC1B64FN,C0Bx5FE,oEACE,oB1B25FJ,C0B55FE,8DACE,oB1B25FJ,C0B55FE,kDACE,oB1B25FJ,C0Bv5FE,2EACE,oC1B05FJ,C0B35FE,qEACE,oC1B05FJ,C0B35FE,yDACE,oC1B05FJ,C0Bv5FI,kFACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1By5FN,C0B35FI,4EACE,wBAnBG,CAoBH,6C1By5FN,C0B35FI,gEACE,wBAnBG,CAoBH,qDAAA,CAAA,6C1By5FN,C0Bp6FE,wEACE,oB1Bu6FJ,C0Bx6FE,kEACE,oB1Bu6FJ,C0Bx6FE,sDACE,oB1Bu6FJ,C0Bn6FE,+EACE,kC1Bs6FJ,C0Bv6FE,yEACE,kC1Bs6FJ,C0Bv6FE,6DACE,kC1Bs6FJ,C0Bn6FI,sFACE,wBAnBG,CAoBH,mDAAA,CAAA,2C1Bq6FN,C0Bv6FI,gFACE,wBAnBG,CAoBH,2C1Bq6FN,C0Bv6FI,oEACE,wBAnBG,CAoBH,mDAAA,CAAA,2C1Bq6FN,C4B5jGA,MACE,wM5B+jGF,C4BtjGE,sBACE,uCAAA,CACA,gB5ByjGJ,C4BtjGI,mCACE,a5BwjGN,C4BzjGI,mCACE,c5BwjGN,C4BpjGM,4BACE,sB5BsjGR,C4BnjGQ,mCACE,gC5BqjGV,C4BjjGQ,2DAEE,SAAA,CADA,uBAAA,CAEA,e5BmjGV,C4B/iGQ,0EAEE,SAAA,CADA,uB5BkjGV,C4BnjGQ,uEAEE,SAAA,CADA,uB5BkjGV,C4BnjGQ,iEAEE,SAAA,CADA,uB5BkjGV,C4B7iGQ,yCACE,Y5B+iGV,C4BxiGE,0BAEE,eAAA,CADA,e5B2iGJ,C4BviGI,+BACE,oB5ByiGN,C4BpiGE,gDACE,Y5BsiGJ,C4BliGE,8BAEE,+BAAA,CADA,oBAAA,CAGA,WAAA,CAGA,SAAA,CADA,4BAAA,CAEA,4DACE,CAJF,0B5BsiGJ,C4B7hGI,aAdF,8BAeI,+BAAA,CAEA,SAAA,CADA,uB5BiiGJ,CACF,C4B7hGI,wCACE,6B5B+hGN,C4B3hGI,oCACE,+B5B6hGN,C4BzhGI,qCAIE,6BAAA,CAKA,UAAA,CARA,oBAAA,CAEA,YAAA,CAEA,2CAAA,CAAA,mCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CANA,W5BkiGN,C4BrhGQ,mDACE,oB5BuhGV,C6BroGE,kCAEE,iB7B2oGJ,C6B7oGE,kCAEE,kB7B2oGJ,C6B7oGE,wBAGE,yCAAA,CAFA,oBAAA,CAGA,SAAA,CACA,mC7BwoGJ,C6BnoGI,aAVF,wBAWI,Y7BsoGJ,CACF,C6BloGE,mFAEE,SAAA,CACA,2CACE,CADF,mC7BooGJ,C6BvoGE,gFAEE,SAAA,CACA,wCACE,CADF,mC7BooGJ,C6BvoGE,0EAEE,SAAA,CACA,mC7BooGJ,C6B9nGE,mFAEE,+B7BgoGJ,C6BloGE,gFAEE,+B7BgoGJ,C6BloGE,0EAEE,+B7BgoGJ,C6B5nGE,oBACE,yBAAA,CACA,uBAAA,CAGA,yE7B4nGJ,CK7/FI,sCwBrHE,qDACE,uB7BqnGN,CACF,C6BhnGE,0CACE,yB7BknGJ,C6BnnGE,uCACE,yB7BknGJ,C6BnnGE,iCACE,yB7BknGJ,C6B9mGE,sBACE,0B7BgnGJ,C8B3qGE,2BACE,a9B8qGJ,CKz/FI,wCyBtLF,2BAKI,e9B8qGJ,CACF,C8B3qGI,6BAEE,0BAAA,CAAA,2BAAA,CACA,eAAA,CACA,iBAAA,CAHA,yBAAA,CAAA,sBAAA,CAAA,iB9BgrGN,C8B1qGM,2CACE,kB9B4qGR,C+B7rGE,kDACE,kCAAA,CAAA,0B/BgsGJ,C+BjsGE,+CACE,0B/BgsGJ,C+BjsGE,yCACE,kCAAA,CAAA,0B/BgsGJ,C+B5rGE,uBACE,4C/B8rGJ,C+B1rGE,uBACE,4C/B4rGJ,C+BxrGE,4BACE,qC/B0rGJ,C+BvrGI,mCACE,a/ByrGN,C+BrrGI,kCACE,a/BurGN,C+BlrGE,0BAKE,eAAA,CAJA,aAAA,CACA,YAAA,CAEA,aAAA,CADA,kBAAA,CAAA,mB/BsrGJ,C+BjrGI,uCACE,e/BmrGN,C+B/qGI,sCACE,kB/BirGN,CgChuGA,MACE,8LhCmuGF,CgC1tGE,oBACE,iBAAA,CAEA,gBAAA,CADA,ahC8tGJ,CgC1tGI,wCACE,uBhC4tGN,CgCxtGI,gCAEE,eAAA,CADA,gBhC2tGN,CgCptGM,wCACE,mBhCstGR,CgChtGE,8BAGE,oBhCqtGJ,CgCxtGE,8BAGE,mBhCqtGJ,CgCxtGE,8BAIE,4BhCotGJ,CgCxtGE,4DAKE,6BhCmtGJ,CgCxtGE,8BAKE,4BhCmtGJ,CgCxtGE,oBAME,cAAA,CALA,aAAA,CACA,ehCstGJ,CgC/sGI,kCACE,uCAAA,CACA,oBhCitGN,CgC7sGI,wCAEE,uCAAA,CADA,YhCgtGN,CgC3sGI,oCAGE,WhCutGN,CgC1tGI,oCAGE,UhCutGN,CgC1tGI,0BAME,6BAAA,CAOA,UAAA,CARA,WAAA,CAEA,yCAAA,CAAA,iCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CATA,iBAAA,CACA,UAAA,CASA,sBAAA,CACA,yBAAA,CARA,UhCstGN,CgC1sGM,oCACE,wBhC4sGR,CgCvsGI,4BACE,YhCysGN,CgCpsGI,4CACE,YhCssGN,CiCzxGE,qDACE,mBAAA,CACA,cAAA,CACA,uBjC4xGJ,CiC/xGE,kDACE,mBAAA,CACA,cAAA,CACA,uBjC4xGJ,CiC/xGE,4CACE,mBAAA,CACA,cAAA,CACA,uBjC4xGJ,CiCzxGI,yDAGE,iBAAA,CADA,eAAA,CADA,ajC6xGN,CiC9xGI,sDAGE,iBAAA,CADA,eAAA,CADA,ajC6xGN,CiC9xGI,gDAGE,iBAAA,CADA,eAAA,CADA,ajC6xGN,CkCnyGE,gCACE,sClCsyGJ,CkCvyGE,6BACE,sClCsyGJ,CkCvyGE,uBACE,sClCsyGJ,CkCnyGE,cACE,yClCqyGJ,CkCzxGE,4DACE,oClC2xGJ,CkC5xGE,yDACE,oClC2xGJ,CkC5xGE,mDACE,oClC2xGJ,CkCnxGE,6CACE,qClCqxGJ,CkCtxGE,0CACE,qClCqxGJ,CkCtxGE,oCACE,qClCqxGJ,CkC3wGE,oDACE,oClC6wGJ,CkC9wGE,iDACE,oClC6wGJ,CkC9wGE,2CACE,oClC6wGJ,CkCpwGE,gDACE,qClCswGJ,CkCvwGE,6CACE,qClCswGJ,CkCvwGE,uCACE,qClCswGJ,CkCjwGE,gCACE,kClCmwGJ,CkCpwGE,6BACE,kClCmwGJ,CkCpwGE,uBACE,kClCmwGJ,CkC7vGE,qCACE,sClC+vGJ,CkChwGE,kCACE,sClC+vGJ,CkChwGE,4BACE,sClC+vGJ,CkCxvGE,yCACE,sClC0vGJ,CkC3vGE,sCACE,sClC0vGJ,CkC3vGE,gCACE,sClC0vGJ,CkCnvGE,yCACE,qClCqvGJ,CkCtvGE,sCACE,qClCqvGJ,CkCtvGE,gCACE,qClCqvGJ,CkC5uGE,gDACE,qClC8uGJ,CkC/uGE,6CACE,qClC8uGJ,CkC/uGE,uCACE,qClC8uGJ,CkCtuGE,6CACE,sClCwuGJ,CkCzuGE,0CACE,sClCwuGJ,CkCzuGE,oCACE,sClCwuGJ,CkC7tGE,yDACE,qClC+tGJ,CkChuGE,sDACE,qClC+tGJ,CkChuGE,gDACE,qClC+tGJ,CkC1tGE,iCAGE,mBAAA,CAFA,gBAAA,CACA,gBlC6tGJ,CkC/tGE,8BAGE,mBAAA,CAFA,gBAAA,CACA,gBlC6tGJ,CkC/tGE,wBAGE,mBAAA,CAFA,gBAAA,CACA,gBlC6tGJ,CkCztGE,eACE,4ClC2tGJ,CkCxtGE,eACE,4ClC0tGJ,CkCttGE,gBAIE,wCAAA,CAHA,aAAA,CACA,wBAAA,CACA,wBlCytGJ,CkCptGE,yBAOE,wCAAA,CACA,+DAAA,CACA,4BAAA,CACA,6BAAA,CARA,iBAAA,CAIA,eAAA,CADA,eAAA,CAFA,cAAA,CACA,oCAAA,CAHA,iBlC+tGJ,CkCntGI,6BACE,YlCqtGN,CkCltGM,kCACE,wBAAA,CACA,yBlCotGR,CkC9sGE,iCAWE,wCAAA,CACA,+DAAA,CAFA,uCAAA,CAGA,0BAAA,CAPA,UAAA,CAJA,oBAAA,CAMA,2BAAA,CADA,2BAAA,CAEA,2BAAA,CARA,uBAAA,CAAA,eAAA,CAaA,wBAAA,CAAA,qBAAA,CAAA,oBAAA,CAAA,gBAAA,CATA,SlCutGJ,CkCrsGE,sBACE,iBAAA,CACA,iBlCusGJ,CkC/rGI,sCACE,gBlCisGN,CkC7rGI,gDACE,YlC+rGN,CkCrrGA,gBACE,iBlCwrGF,CkCprGE,uCACE,aAAA,CACA,SlCsrGJ,CkCxrGE,oCACE,aAAA,CACA,SlCsrGJ,CkCxrGE,8BACE,aAAA,CACA,SlCsrGJ,CkCjrGE,mBACE,YlCmrGJ,CkC9qGE,oBACE,QlCgrGJ,CkC5qGE,4BACE,WAAA,CACA,SAAA,CACA,elC8qGJ,CkC3qGI,0CACE,YlC6qGN,CkCvqGE,yBAIE,wCAAA,CAEA,+BAAA,CADA,4BAAA,CAFA,eAAA,CADA,oDAAA,CAKA,wBAAA,CAAA,qBAAA,CAAA,oBAAA,CAAA,gBlCyqGJ,CkCrqGE,2BAEE,+DAAA,CADA,2BlCwqGJ,CkCpqGI,+BACE,uCAAA,CACA,gBlCsqGN,CkCjqGE,sBACE,MAAA,CACA,WlCmqGJ,CkC9pGA,aACE,alCiqGF,CkCvpGE,4BAEE,aAAA,CADA,YlC2pGJ,CkCvpGI,wDAEE,2BAAA,CADA,wBlC0pGN,CkCppGE,+BAKE,2CAAA,CAEA,+BAAA,CADA,gCAAA,CADA,sBAAA,CAJA,mBAAA,CAEA,gBAAA,CADA,alC2pGJ,CkCnpGI,qCAEE,UAAA,CACA,UAAA,CAFA,alCupGN,CKxxGI,wC6BgJF,8BACE,iBlC4oGF,CkCloGE,wSAGE,elCwoGJ,CkCpoGE,sCAEE,mBAAA,CACA,eAAA,CADA,oBAAA,CADA,kBAAA,CAAA,mBlCwoGJ,CACF,CD/9GI,kDAIE,+BAAA,CACA,8BAAA,CAFA,aAAA,CADA,QAAA,CADA,iBCq+GN,CDt+GI,+CAIE,+BAAA,CACA,8BAAA,CAFA,aAAA,CADA,QAAA,CADA,iBCq+GN,CDt+GI,yCAIE,+BAAA,CACA,8BAAA,CAFA,aAAA,CADA,QAAA,CADA,iBCq+GN,CD79GI,uBAEE,uCAAA,CADA,cCg+GN,CD36GM,iHAEE,WAlDkB,CAiDlB,kBCs7GR,CDv7GM,6HAEE,WAlDkB,CAiDlB,kBCk8GR,CDn8GM,6HAEE,WAlDkB,CAiDlB,kBC88GR,CD/8GM,oHAEE,WAlDkB,CAiDlB,kBC09GR,CD39GM,0HAEE,WAlDkB,CAiDlB,kBCs+GR,CDv+GM,uHAEE,WAlDkB,CAiDlB,kBCk/GR,CDn/GM,uHAEE,WAlDkB,CAiDlB,kBC8/GR,CD//GM,6HAEE,WAlDkB,CAiDlB,kBC0gHR,CD3gHM,yCAEE,WAlDkB,CAiDlB,kBC8gHR,CD/gHM,yCAEE,WAlDkB,CAiDlB,kBCkhHR,CDnhHM,0CAEE,WAlDkB,CAiDlB,kBCshHR,CDvhHM,uCAEE,WAlDkB,CAiDlB,kBC0hHR,CD3hHM,wCAEE,WAlDkB,CAiDlB,kBC8hHR,CD/hHM,sCAEE,WAlDkB,CAiDlB,kBCkiHR,CDniHM,wCAEE,WAlDkB,CAiDlB,kBCsiHR,CDviHM,oCAEE,WAlDkB,CAiDlB,kBC0iHR,CD3iHM,2CAEE,WAlDkB,CAiDlB,kBC8iHR,CD/iHM,qCAEE,WAlDkB,CAiDlB,kBCkjHR,CDnjHM,oCAEE,WAlDkB,CAiDlB,kBCsjHR,CDvjHM,kCAEE,WAlDkB,CAiDlB,kBC0jHR,CD3jHM,qCAEE,WAlDkB,CAiDlB,kBC8jHR,CD/jHM,mCAEE,WAlDkB,CAiDlB,kBCkkHR,CDnkHM,qCAEE,WAlDkB,CAiDlB,kBCskHR,CDvkHM,wCAEE,WAlDkB,CAiDlB,kBC0kHR,CD3kHM,sCAEE,WAlDkB,CAiDlB,kBC8kHR,CD/kHM,2CAEE,WAlDkB,CAiDlB,kBCklHR,CDvkHM,iCAEE,WAPkB,CAMlB,iBC0kHR,CD3kHM,uCAEE,WAPkB,CAMlB,iBC8kHR,CD/kHM,mCAEE,WAPkB,CAMlB,iBCklHR,CmCpqHA,MACE,qMAAA,CACA,mMnCuqHF,CmC9pHE,wBAKE,mBAAA,CAHA,YAAA,CACA,qBAAA,CACA,YAAA,CAHA,iBnCqqHJ,CmC3pHI,8BAGE,QAAA,CACA,SAAA,CAHA,iBAAA,CACA,OnC+pHN,CmC1pHM,qCACE,0BnC4pHR,CmC7nHE,2BAKE,uBAAA,CADA,+DAAA,CAHA,YAAA,CACA,cAAA,CACA,aAAA,CAGA,oBnC+nHJ,CmC5nHI,aATF,2BAUI,gBnC+nHJ,CACF,CmC5nHI,cAGE,+BACE,iBnC4nHN,CmCznHM,sCAOE,oCAAA,CALA,QAAA,CAWA,UAAA,CATA,aAAA,CAEA,UAAA,CAHA,MAAA,CAFA,iBAAA,CAOA,2CAAA,CACA,qCACE,CAEF,kDAAA,CAPA,+BnCioHR,CACF,CmCpnHI,8CACE,YnCsnHN,CmClnHI,iCAQE,qCAAA,CACA,6BAAA,CALA,uCAAA,CAMA,cAAA,CATA,aAAA,CAKA,gBAAA,CADA,eAAA,CAFA,8BAAA,CAWA,+BAAA,CAHA,2CACE,CALF,kBAAA,CALA,UnC8nHN,CmC/mHM,aAII,6CACE,OnC8mHV,CmC/mHQ,8CACE,OnCinHV,CmClnHQ,8CACE,OnConHV,CmCrnHQ,8CACE,OnCunHV,CmCxnHQ,8CACE,OnC0nHV,CmC3nHQ,8CACE,OnC6nHV,CmC9nHQ,8CACE,OnCgoHV,CmCjoHQ,8CACE,OnCmoHV,CmCpoHQ,8CACE,OnCsoHV,CmCvoHQ,+CACE,QnCyoHV,CmC1oHQ,+CACE,QnC4oHV,CmC7oHQ,+CACE,QnC+oHV,CmChpHQ,+CACE,QnCkpHV,CmCnpHQ,+CACE,QnCqpHV,CmCtpHQ,+CACE,QnCwpHV,CmCzpHQ,+CACE,QnC2pHV,CmC5pHQ,+CACE,QnC8pHV,CmC/pHQ,+CACE,QnCiqHV,CmClqHQ,+CACE,QnCoqHV,CmCrqHQ,+CACE,QnCuqHV,CACF,CmClqHM,uCACE,+BnCoqHR,CmC9pHE,4BACE,UnCgqHJ,CmC7pHI,aAJF,4BAKI,gBnCgqHJ,CACF,CmC5pHE,0BACE,YnC8pHJ,CmC3pHI,aAJF,0BAKI,anC8pHJ,CmC1pHM,sCACE,OnC4pHR,CmC7pHM,uCACE,OnC+pHR,CmChqHM,uCACE,OnCkqHR,CmCnqHM,uCACE,OnCqqHR,CmCtqHM,uCACE,OnCwqHR,CmCzqHM,uCACE,OnC2qHR,CmC5qHM,uCACE,OnC8qHR,CmC/qHM,uCACE,OnCirHR,CmClrHM,uCACE,OnCorHR,CmCrrHM,wCACE,QnCurHR,CmCxrHM,wCACE,QnC0rHR,CmC3rHM,wCACE,QnC6rHR,CmC9rHM,wCACE,QnCgsHR,CmCjsHM,wCACE,QnCmsHR,CmCpsHM,wCACE,QnCssHR,CmCvsHM,wCACE,QnCysHR,CmC1sHM,wCACE,QnC4sHR,CmC7sHM,wCACE,QnC+sHR,CmChtHM,wCACE,QnCktHR,CmCntHM,wCACE,QnCqtHR,CACF,CmC/sHI,+FAEE,QnCitHN,CmC9sHM,yGACE,wBAAA,CACA,yBnCitHR,CmCxsHM,2DAEE,wBAAA,CACA,yBAAA,CAFA,QnC4sHR,CmCrsHM,iEACE,QnCusHR,CmCpsHQ,qLAGE,wBAAA,CACA,yBAAA,CAFA,QnCwsHV,CmClsHQ,6FACE,wBAAA,CACA,yBnCosHV,CmC/rHM,yDACE,kBnCisHR,CmC5rHI,sCACE,QnC8rHN,CmCzrHE,2BAEE,iBAAA,CAKA,kBAAA,CADA,uCAAA,CAEA,cAAA,CAPA,aAAA,CAGA,YAAA,CACA,gBAAA,CAKA,mBAAA,CADA,gCAAA,CANA,WnCksHJ,CmCxrHI,iCAEE,uDAAA,CADA,+BnC2rHN,CmCtrHI,iCAIE,6BAAA,CAQA,UAAA,CAXA,aAAA,CAEA,WAAA,CAKA,8CAAA,CAAA,sCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CANA,+CACE,CAJF,UnCgsHN,CmCjrHE,4BAME,+EACE,CALF,YAAA,CAGA,aAAA,CAFA,qBAAA,CAUA,mBAAA,CAZA,iBAAA,CAWA,wBAAA,CARA,YnCurHJ,CmC3qHI,sCACE,wBnC6qHN,CmCzqHI,oCACE,SnC2qHN,CmCvqHI,kCAGE,8EACE,CAFF,mBAAA,CADA,OnC2qHN,CmCjqHM,uDACE,8CAAA,CAAA,sCnCmqHR,CKnxHI,wC8B8HF,wDAGE,kBnC0pHF,CmC7pHA,wDAGE,mBnC0pHF,CmC7pHA,8CAEE,eAAA,CADA,eAAA,CAGA,iCnCypHF,CmCrpHE,8DACE,mBnCwpHJ,CmCzpHE,8DACE,kBnCwpHJ,CmCzpHE,oDAEE,UnCupHJ,CmCnpHE,8EAEE,kBnCspHJ,CmCxpHE,8EAEE,mBnCspHJ,CmCxpHE,8EAGE,kBnCqpHJ,CmCxpHE,8EAGE,mBnCqpHJ,CmCxpHE,oEACE,UnCupHJ,CmCjpHE,8EAEE,mBnCopHJ,CmCtpHE,8EAEE,kBnCopHJ,CmCtpHE,8EAGE,mBnCmpHJ,CmCtpHE,8EAGE,kBnCmpHJ,CmCtpHE,oEACE,UnCqpHJ,CACF,CmCvoHE,cAHF,olDAII,+BnC0oHF,CmCvoHE,g8GACE,sCnCyoHJ,CACF,CmCpoHA,4sDACE,uDnCuoHF,CmCnoHA,wmDACE,anCsoHF,CoCn/HA,MACE,mVAAA,CAEA,4VpCu/HF,CoC7+HE,4BAEE,oBAAA,CADA,iBpCi/HJ,CoC5+HI,sDAGE,SpC8+HN,CoCj/HI,sDAGE,UpC8+HN,CoCj/HI,4CACE,iBAAA,CACA,SpC++HN,CoCz+HE,+CAEE,SAAA,CADA,UpC4+HJ,CoCv+HE,kDAGE,WpCi/HJ,CoCp/HE,kDAGE,YpCi/HJ,CoCp/HE,wCAME,qDAAA,CAKA,UAAA,CANA,aAAA,CAEA,0CAAA,CAAA,kCAAA,CACA,4BAAA,CAAA,oBAAA,CACA,6BAAA,CAAA,qBAAA,CACA,yBAAA,CAAA,iBAAA,CATA,iBAAA,CACA,SAAA,CAEA,YpCg/HJ,CoCr+HE,gEACE,wBTyWa,CSxWb,mDAAA,CAAA,2CpCu+HJ,CqCzhIA,QACE,8DAAA,CAGA,+CAAA,CACA,iEAAA,CACA,oDAAA,CACA,sDAAA,CACA,mDrC0hIF,CqCthIA,SAEE,kBAAA,CADA,YrC0hIF,CKj4HI,mCiChKA,8BACE,UtCyiIJ,CsC1iIE,8BACE,WtCyiIJ,CsC1iIE,8BAIE,kBtCsiIJ,CsC1iIE,8BAIE,iBtCsiIJ,CsC1iIE,oBAKE,mBAAA,CAFA,YAAA,CADA,atCwiIJ,CsCliII,kCACE,WtCqiIN,CsCtiII,kCACE,UtCqiIN,CsCtiII,kCAEE,iBAAA,CAAA,ctCoiIN,CsCtiII,kCAEE,aAAA,CAAA,kBtCoiIN,CACF","file":"main.css"} \ No newline at end of file diff --git a/assets/stylesheets/palette.cbb835fc.min.css b/assets/stylesheets/palette.cbb835fc.min.css new file mode 100644 index 00000000..30f9264c --- /dev/null +++ b/assets/stylesheets/palette.cbb835fc.min.css @@ -0,0 +1 @@ +@media screen{[data-md-color-scheme=slate]{--md-hue:232;--md-default-fg-color:hsla(var(--md-hue),75%,95%,1);--md-default-fg-color--light:hsla(var(--md-hue),75%,90%,0.62);--md-default-fg-color--lighter:hsla(var(--md-hue),75%,90%,0.32);--md-default-fg-color--lightest:hsla(var(--md-hue),75%,90%,0.12);--md-default-bg-color:hsla(var(--md-hue),15%,21%,1);--md-default-bg-color--light:hsla(var(--md-hue),15%,21%,0.54);--md-default-bg-color--lighter:hsla(var(--md-hue),15%,21%,0.26);--md-default-bg-color--lightest:hsla(var(--md-hue),15%,21%,0.07);--md-code-fg-color:hsla(var(--md-hue),18%,86%,1);--md-code-bg-color:hsla(var(--md-hue),15%,15%,1);--md-code-hl-color:rgba(66,135,255,.15);--md-code-hl-number-color:#e6695b;--md-code-hl-special-color:#f06090;--md-code-hl-function-color:#c973d9;--md-code-hl-constant-color:#9383e2;--md-code-hl-keyword-color:#6791e0;--md-code-hl-string-color:#2fb170;--md-code-hl-name-color:var(--md-code-fg-color);--md-code-hl-operator-color:var(--md-default-fg-color--light);--md-code-hl-punctuation-color:var(--md-default-fg-color--light);--md-code-hl-comment-color:var(--md-default-fg-color--light);--md-code-hl-generic-color:var(--md-default-fg-color--light);--md-code-hl-variable-color:var(--md-default-fg-color--light);--md-typeset-color:var(--md-default-fg-color);--md-typeset-a-color:var(--md-primary-fg-color);--md-typeset-mark-color:rgba(66,135,255,.3);--md-typeset-kbd-color:hsla(var(--md-hue),15%,94%,0.12);--md-typeset-kbd-accent-color:hsla(var(--md-hue),15%,94%,0.2);--md-typeset-kbd-border-color:hsla(var(--md-hue),15%,14%,1);--md-typeset-table-color:hsla(var(--md-hue),75%,95%,0.12);--md-admonition-fg-color:var(--md-default-fg-color);--md-admonition-bg-color:var(--md-default-bg-color);--md-footer-bg-color:hsla(var(--md-hue),15%,12%,0.87);--md-footer-bg-color--dark:hsla(var(--md-hue),15%,10%,1);--md-shadow-z1:0 0.2rem 0.5rem rgba(0,0,0,.2),0 0 0.05rem rgba(0,0,0,.1);--md-shadow-z2:0 0.2rem 0.5rem rgba(0,0,0,.3),0 0 0.05rem rgba(0,0,0,.25);--md-shadow-z3:0 0.2rem 0.5rem rgba(0,0,0,.4),0 0 0.05rem rgba(0,0,0,.35)}[data-md-color-scheme=slate] img[src$="#gh-light-mode-only"],[data-md-color-scheme=slate] img[src$="#only-light"]{display:none}[data-md-color-scheme=slate] img[src$="#gh-dark-mode-only"],[data-md-color-scheme=slate] img[src$="#only-dark"]{display:initial}[data-md-color-scheme=slate][data-md-color-primary=pink]{--md-typeset-a-color:#ed5487}[data-md-color-scheme=slate][data-md-color-primary=purple]{--md-typeset-a-color:#bd78c9}[data-md-color-scheme=slate][data-md-color-primary=deep-purple]{--md-typeset-a-color:#a682e3}[data-md-color-scheme=slate][data-md-color-primary=indigo]{--md-typeset-a-color:#6c91d5}[data-md-color-scheme=slate][data-md-color-primary=teal]{--md-typeset-a-color:#00ccb8}[data-md-color-scheme=slate][data-md-color-primary=green]{--md-typeset-a-color:#71c174}[data-md-color-scheme=slate][data-md-color-primary=deep-orange]{--md-typeset-a-color:#ff9575}[data-md-color-scheme=slate][data-md-color-primary=brown]{--md-typeset-a-color:#c7846b}[data-md-color-scheme=slate][data-md-color-primary=black],[data-md-color-scheme=slate][data-md-color-primary=blue-grey],[data-md-color-scheme=slate][data-md-color-primary=grey],[data-md-color-scheme=slate][data-md-color-primary=white]{--md-typeset-a-color:#6c91d5}[data-md-color-switching] *,[data-md-color-switching] :after,[data-md-color-switching] :before{transition-duration:0ms!important}}[data-md-color-accent=red]{--md-accent-fg-color:#ff1947;--md-accent-fg-color--transparent:rgba(255,25,71,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=pink]{--md-accent-fg-color:#f50056;--md-accent-fg-color--transparent:rgba(245,0,86,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=purple]{--md-accent-fg-color:#df41fb;--md-accent-fg-color--transparent:rgba(223,65,251,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=deep-purple]{--md-accent-fg-color:#7c4dff;--md-accent-fg-color--transparent:rgba(124,77,255,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=indigo]{--md-accent-fg-color:#526cfe;--md-accent-fg-color--transparent:rgba(82,108,254,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=blue]{--md-accent-fg-color:#4287ff;--md-accent-fg-color--transparent:rgba(66,135,255,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=light-blue]{--md-accent-fg-color:#0091eb;--md-accent-fg-color--transparent:rgba(0,145,235,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=cyan]{--md-accent-fg-color:#00bad6;--md-accent-fg-color--transparent:rgba(0,186,214,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=teal]{--md-accent-fg-color:#00bda4;--md-accent-fg-color--transparent:rgba(0,189,164,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=green]{--md-accent-fg-color:#00c753;--md-accent-fg-color--transparent:rgba(0,199,83,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=light-green]{--md-accent-fg-color:#63de17;--md-accent-fg-color--transparent:rgba(99,222,23,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-accent=lime]{--md-accent-fg-color:#b0eb00;--md-accent-fg-color--transparent:rgba(176,235,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=yellow]{--md-accent-fg-color:#ffd500;--md-accent-fg-color--transparent:rgba(255,213,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=amber]{--md-accent-fg-color:#fa0;--md-accent-fg-color--transparent:rgba(255,170,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=orange]{--md-accent-fg-color:#ff9100;--md-accent-fg-color--transparent:rgba(255,145,0,.1);--md-accent-bg-color:rgba(0,0,0,.87);--md-accent-bg-color--light:rgba(0,0,0,.54)}[data-md-color-accent=deep-orange]{--md-accent-fg-color:#ff6e42;--md-accent-fg-color--transparent:rgba(255,110,66,.1);--md-accent-bg-color:#fff;--md-accent-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=red]{--md-primary-fg-color:#ef5552;--md-primary-fg-color--light:#e57171;--md-primary-fg-color--dark:#e53734;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=pink]{--md-primary-fg-color:#e92063;--md-primary-fg-color--light:#ec417a;--md-primary-fg-color--dark:#c3185d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=purple]{--md-primary-fg-color:#ab47bd;--md-primary-fg-color--light:#bb69c9;--md-primary-fg-color--dark:#8c24a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=deep-purple]{--md-primary-fg-color:#7e56c2;--md-primary-fg-color--light:#9574cd;--md-primary-fg-color--dark:#673ab6;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=indigo]{--md-primary-fg-color:#4051b5;--md-primary-fg-color--light:#5d6cc0;--md-primary-fg-color--dark:#303fa1;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=blue]{--md-primary-fg-color:#2094f3;--md-primary-fg-color--light:#42a5f5;--md-primary-fg-color--dark:#1975d2;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=light-blue]{--md-primary-fg-color:#02a6f2;--md-primary-fg-color--light:#28b5f6;--md-primary-fg-color--dark:#0287cf;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=cyan]{--md-primary-fg-color:#00bdd6;--md-primary-fg-color--light:#25c5da;--md-primary-fg-color--dark:#0097a8;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=teal]{--md-primary-fg-color:#009485;--md-primary-fg-color--light:#26a699;--md-primary-fg-color--dark:#007a6c;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=green]{--md-primary-fg-color:#4cae4f;--md-primary-fg-color--light:#68bb6c;--md-primary-fg-color--dark:#398e3d;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=light-green]{--md-primary-fg-color:#8bc34b;--md-primary-fg-color--light:#9ccc66;--md-primary-fg-color--dark:#689f38;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=lime]{--md-primary-fg-color:#cbdc38;--md-primary-fg-color--light:#d3e156;--md-primary-fg-color--dark:#b0b52c;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=yellow]{--md-primary-fg-color:#ffec3d;--md-primary-fg-color--light:#ffee57;--md-primary-fg-color--dark:#fbc02d;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=amber]{--md-primary-fg-color:#ffc105;--md-primary-fg-color--light:#ffc929;--md-primary-fg-color--dark:#ffa200;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=orange]{--md-primary-fg-color:#ffa724;--md-primary-fg-color--light:#ffa724;--md-primary-fg-color--dark:#fa8900;--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54)}[data-md-color-primary=deep-orange]{--md-primary-fg-color:#ff6e42;--md-primary-fg-color--light:#ff8a66;--md-primary-fg-color--dark:#f4511f;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=brown]{--md-primary-fg-color:#795649;--md-primary-fg-color--light:#8d6e62;--md-primary-fg-color--dark:#5d4037;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7)}[data-md-color-primary=grey]{--md-primary-fg-color:#757575;--md-primary-fg-color--light:#9e9e9e;--md-primary-fg-color--dark:#616161;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=blue-grey]{--md-primary-fg-color:#546d78;--md-primary-fg-color--light:#607c8a;--md-primary-fg-color--dark:#455a63;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=light-green]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#72ad2e}[data-md-color-primary=lime]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#8b990a}[data-md-color-primary=yellow]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#b8a500}[data-md-color-primary=amber]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#d19d00}[data-md-color-primary=orange]:not([data-md-color-scheme=slate]){--md-typeset-a-color:#e68a00}[data-md-color-primary=white]{--md-primary-fg-color:#fff;--md-primary-fg-color--light:hsla(0,0%,100%,.7);--md-primary-fg-color--dark:rgba(0,0,0,.07);--md-primary-bg-color:rgba(0,0,0,.87);--md-primary-bg-color--light:rgba(0,0,0,.54);--md-typeset-a-color:#4051b5}@media screen and (min-width:60em){[data-md-color-primary=white] .md-search__form{background-color:rgba(0,0,0,.07)}[data-md-color-primary=white] .md-search__form:hover{background-color:rgba(0,0,0,.32)}[data-md-color-primary=white] .md-search__input+.md-search__icon{color:rgba(0,0,0,.87)}}@media screen and (min-width:76.25em){[data-md-color-primary=white] .md-tabs{border-bottom:.05rem solid rgba(0,0,0,.07)}}[data-md-color-primary=black]{--md-primary-fg-color:#000;--md-primary-fg-color--light:rgba(0,0,0,.54);--md-primary-fg-color--dark:#000;--md-primary-bg-color:#fff;--md-primary-bg-color--light:hsla(0,0%,100%,.7);--md-typeset-a-color:#4051b5}[data-md-color-primary=black] .md-header{background-color:#000}@media screen and (max-width:59.9375em){[data-md-color-primary=black] .md-nav__source{background-color:rgba(0,0,0,.87)}}@media screen and (min-width:60em){[data-md-color-primary=black] .md-search__form{background-color:hsla(0,0%,100%,.12)}[data-md-color-primary=black] .md-search__form:hover{background-color:hsla(0,0%,100%,.3)}}@media screen and (max-width:76.1875em){html [data-md-color-primary=black] .md-nav--primary .md-nav__title[for=__drawer]{background-color:#000}}@media screen and (min-width:76.25em){[data-md-color-primary=black] .md-tabs{background-color:#000}} \ No newline at end of file diff --git a/assets/stylesheets/palette.cbb835fc.min.css.map b/assets/stylesheets/palette.cbb835fc.min.css.map new file mode 100644 index 00000000..96e380c8 --- /dev/null +++ b/assets/stylesheets/palette.cbb835fc.min.css.map @@ -0,0 +1 @@ +{"version":3,"sources":["src/assets/stylesheets/palette/_scheme.scss","../../../src/assets/stylesheets/palette.scss","src/assets/stylesheets/palette/_accent.scss","src/assets/stylesheets/palette/_primary.scss","src/assets/stylesheets/utilities/_break.scss"],"names":[],"mappings":"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","file":"palette.css"} \ No newline at end of file diff --git a/docs/glossary/index.html b/docs/glossary/index.html new file mode 100644 index 00000000..018dd9af --- /dev/null +++ b/docs/glossary/index.html @@ -0,0 +1,869 @@ + + + + + + + + + + + + + + + + Glossary - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Glossary

    +

    Construct

    +
      +
    • To construct a workflow in dewret is to pull the connected steps into a single structure.
      • +
    +

    Sub Workflow

    +
      +
    • +

      A subworkflow is a nested or hierarchical workflow. It is a workflow defined within another workflow, allowing for the encapsulation and reuse of complex operations as a single, higher-level step in the parent workflow.

      +
      • +
    • +

      Specific type of task designed to encapsulate multiple tasks. Nested tasks are the culmination (or result) of multiple tasks represented as a single task in a dewret workflow.

      +
      • +
    +

    Render

    +
      +
    • To render a workflow is to generate an executable workflow in a specific workflow language such as CWL and Snakemake.
      • +
    +

    Step

    +
      +
    • A step in a dewret workflow represents a single unit of work. It contains a single task and the arguments for that task. Corresponds to a CWL Step or a Snakemake Rule
      • +
    +

    Task

    +
      +
    • A task is the function scheduled to be executed later. Corresponds to a CWL Process
      • +
    +

    Workflow

    +
      +
    • A workflow is designed to define, manage, and execute a series of tasks that make use of both local and global parameters.
      • +
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/docs/quickstart/index.html b/docs/quickstart/index.html new file mode 100644 index 00000000..fb617d3a --- /dev/null +++ b/docs/quickstart/index.html @@ -0,0 +1,1024 @@ + + + + + + + + + + + + + + + + Quickstart - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Quickstart

    +

    Introduction

    +

    Description

    +

    Dewret is a tool designed for creating complex workflows, written in a dynamic style, to be rendered to a static representation. Dewret provides a programmatic python interface to multiple declarative workflow engines, where workflows are often written in a yaml-like syntax. It makes it easier for users to define tasks and organize them into workflows. Currently, Dewret supports two renderers: Snakemake and CWL, which generate yamls in the corresponding workflow languages.

    +

    What are Workflows?

    +

    Workflows are a collection of tasks or steps designed to automate complex processes. These processes are common in fields like data science, scientific computing and software development, where you can ensure automation. Traditionally, managing workflows can be challenging due to the diversity of backend systems and the complexity of configurations involved.

    +

    What Makes Dewret Unique? Why should I use Dewret?

    +

    Dewret stands out by providing a unified and simplified interface for workflow management, making it accessible to users with varying levels of experience. Here are some key features that make Dewret unique: +- Consistency: offers a consistent interface for defining tasks and workflows. +- Optimization: creating a declarative workflow opens up possibilities for static analysis and refactoring before execution. +- Customization: dewret offers the ability to create custom renderers for workflows in desired languages. This includes default support for CWL and Snakemake workflow languages. The capability to render a single workflow into multiple declarative languages enables users to experiment with different workflow engines. +- Git-versionable workflows: while code can be versioned, changes in a dynamic workflow may not clearly correspond to changes in the executed workflow. By defining a static workflow that is rendered from the dynamic or programmatic workflow, we maintain a precise and trackable history. +- Default Renderers: Snakemake and CWL. +- Debugging: a number of classes of workflow planning bugs will not appear until late in a simulation run that might take days or weeks. Having a declarative and static workflow definition document post-render provides enhanced possibilities for static analysis, helping to catch these issues before startup. +- Continuous Integration and Testing: complex dynamic workflows can be rapidly sense-checked in CI without needing all the hardware and internal algorithms present to run them.

    +

    Installation for pure users

    +

    If you simply want to use Dewret to run workflows, you can install it from PyPI or Conda.

    +

    From PyPI:

    +
    pip install dewret
+
    +

    From Conda:

    +
    conda install conda-forge::dewret
+
    +

    Installation for developers

    +

    From a cloned repository:

    +
    pip install -e .
+
    +

    Usage

    +

    You can render a simple Common Workflow Language CWL workflow from a graph composed of one or more tasks as follows:

    +
    # workflow.py
+
+from dewret.tasks import task
+
+@task()
+def increment(num: int) -> int:
+    return num + 1
+
    +
    $ python -m dewret --pretty workflow.py increment num:3
+
    +
    class: Workflow
+cwlVersion: 1.2
+outputs:
+  out:
+    outputSource: increment-e138626779553199eb2bd678356b640f-num
+    type: int
+steps:
+  increment-e138626779553199eb2bd678356b640f-num
+    in:
+      num:
+        default: 3
+    out:
+    - out
+    run: increment
+
    +

    By default dewret uses a dask backend so that dewret.task wraps a dask.delayed, and renders a CWL workflow.

    +

    Programmatic Usage

    +

    Building and rendering may be done programmatically, +which provides the opportunity to use custom renderers +and backends, as well as bespoke serialization or formatting.

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> 
+>>> @task()
+... def increment(num: int) -> int:
+...     return num + 1
+>>>
+>>> result = increment(num=3)
+>>> workflow = construct(result, simplify_ids=True)
+>>> cwl = render(workflow)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  increment-1-num:
+    default: 3
+    label: num
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: increment-1/out
+    type: int
+steps:
+  increment-1:
+    in:
+      num:
+        source: increment-1-num
+    out:
+    - out
+    run: increment
+
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/docs/renderer_tutorial/index.html b/docs/renderer_tutorial/index.html new file mode 100644 index 00000000..b70b7376 --- /dev/null +++ b/docs/renderer_tutorial/index.html @@ -0,0 +1,1562 @@ + + + + + + + + + + + + + + + + Renderer Tutorial - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Step-by-Step Guide to Writing a Custom Renderer

    +

    1. Understand the Target Workflow Language

    +

    Before writing any code, it is essential to fully understand the target workflow language. This includes syntax, structure, and specific requirements. By breaking down each key dewret.workflow task into smaller components, you can better map your workflow definitions to the target language.

    +

    Example:

    +

    In Snakemake, a workflow task is generally created by: +1. Defining the task. - rule process_data +2. Defining the input required for the rule to run(dependencies). - input: "data/raw_data.txt" +3. Defining the output required for the rule to be considered finished. - output: "data/processed_data.txt" +4. Defining the actual work that the task will do. - in this case:shell: ...

    +
    rule process_data: # Example Snakemake rule/task
+    input:
+        "data/raw_data.txt"
+    output:
+        output_file="data/processed_data.txt"
+    run:
+        with open(output.output_file, "w") as f:
+            f.write("data")
+
+        return output_file
+
    +

    2. Create WorkflowDefinition.

    +

    The WorkflowDefinition class is responsible for transforming each step from a constructed dewret workflow into an executable step in the target workflow language (e.g. a Snakemake rule). This class should encapsulate workflow-level information, such as the list of steps to be executed, and any workflow-scope input/ouput. It should also contain a class method that initializes the WorkflowDefinition from an dewret Workflow (such as from_workflow below), and a method that renders the workflow as a Python dict (as in the render method below).

    +

    Example:

    +
    @define
+class WorkflowDefinition:
+    steps: list[StepDefinition]
+
+    # Returns a WorkflowDefinition instanace.
+    # Steps contains all of the tasks you want to convert to the target WL tasks.
+    @classmethod
+    def from_workflow(cls, workflow: Workflow) -> "WorkflowDefinition":
+        return cls(steps=[StepDefinition.from_step(step) for step in workflow.steps])
+
+    # Returns each task as a Snakemake executable rule.
+    def render(self) -> dict[str, RawType]:
+        return {
+            f"rule {step.name.replace("-", "_")}": step.render() for step in self.steps
+        }
+
    +

    3. Ensuring Our Module is Recognized as a Render Module

    +

    To have our custom renderer identified by Dewret as a valid renderer, we need to implement the BaseRenderModule along with one of the two protocols: RawRenderModule or StructuredRenderModule.

    +

    Implementing BaseRenderModule

    +

    The BaseRenderModule defines the foundation for a custom renderer. To implement this protocol, we need to define the default_config() method, which provides default configurations for our renderer.

    +
    def default_config() -> CWLRendererConfiguration:
+    """Default configuration for this renderer.
+
+    This is a hook-like call to give a configuration dict that this renderer
+    will respect, and sets any necessary default values.
+
+    Returns: a dict with (preferably) raw type structures to enable easy setting
+        from YAML/JSON.
+    """
+    return {
+        "allow_complex_types": False,
+        "factories_as_params": False,
+    }
+
    +

    After implementing BaseRenderModule, you need to implement either the RawRenderModule or StructuredRenderModule protocol, depending on how you want to handle the workflow rendering.

    +

    Implementing either RawRenderModule or StructuredRenderModule

    +

    The StructuredRenderModule is designed for structured workflows that are directly ready to be output in the respective format (e.g., CWL, Snakemake, etc.). The key method to implement is render, which converts a workflow into a structured, serializable format. +

    def render(
+        self, workflow: WorkflowProtocol, **kwargs: RenderConfiguration
+    ) -> dict[str, dict[str, RawType]]:
+        """Turn a workflow into a serializable structure.
+
+        Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least.
+        """
+        ...
+
    +In this method: +- You receive a workflow and potentially some optional configurations. +- You return a dictionary where the __root__ key holds the primary workflow and any additional subworkflows are nested inside the returned structure.

    +

    If you prefer more flexibility and want the structuring to be handled by the user, you can implement the RawRenderModule protocol. This requires defining the render_raw method, which converts a workflow into raw, flat strings. +

        def render_raw(
+        self, workflow: WorkflowProtocol, **kwargs: RenderConfiguration
+    ) -> dict[str, str]:
+        """Turn a workflow into flat strings.
+
+        Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least.
+        """
+        ...
+
    +In this method:

    +
      +
    • The workflow is rendered as raw, unstructured strings.
      • +
    • The user is responsible for handling the structuring of the rendered output.
      • +
    +

    4. Create a StepDefinition.

    +

    Create a StepsDefinition class create each of the code blocks needed for a rule(step) to be executable in Snakemake. +When you have defined each block in your target workflow language task from step 1, +you can go ahead and create, for each of the code blocks required to run a Snakemake rule, a BlockDefinition to handle the rendering of each block.

    +

    Example:

    +

    In the Snakemake example, we have created: +1. InputDefinition - Handles the input block, which contains what is required for a rule to be executed. It also handles the params block since the code for extracting the input and params blocks is similar. +2. RunDefinition - Handles the run block which contains the instructions needed for this specific task. +3. OutputDefinition - Handles the output block which is required for the rule to be considered successfully finished.

    +
    @define
+class StepDefinition:
+    """Represents a Snakemake-renderable step definition in a dewret workflow.
+
+    Attributes:
+        name (str): The name of the step.
+        run (str): The run block definition for the step.
+        params (List[str]): The parameter definitions for the step.
+        output (list[str]: The output definition for the step.
+        input (List[str]): The input definitions for the step.
+
+    Methods:
+        from_step(cls, step: Step) -> "StepDefinition": Constructs a StepDefinition
+            object from a Step object, extracting step information and components
+            from the step and converting them to Snakemake format.
+        render(self) -> dict[str, MainTypes]: Renders the step definition as a dictionary
+            suitable for use in Snakemake workflows.
+    """
+
+    # You can consider each step as a separate rule.
+    # Each field in this class represents a separate block in the rule definition
+    name: str # name of the rule
+    input: list[str] # Input block
+    params: list[str] # Params block
+    output: list[str] # Output block
+    run: list[str] # Run block - where the instructions for the task are
+
+    @classmethod
+    def from_step(cls, step: Step) -> "StepDefinition":
+        """Constructs a StepDefinition object from a Step.
+
+        Args:
+            step (Step): The Step object from which step information and components
+                are extracted.
+
+        Returns:
+            StepDefinition: A StepDefinition object containing the converted step
+                information and components.
+        """
+        input_block = InputDefinition.from_step(step).render()
+        run_block = RunDefinition.from_task(step.task).render()
+        output_block = OutputDefinition.from_step(step).render()
+        return cls(
+            name=step.name, 
+            run=run_block,
+            params=input_block["params"],
+            input=input_block["inputs"],
+            output=output_block,
+        )
+
+    def render(self) -> dict[str, MainTypes]:
+        """Renders the step definition as a dictionary.
+
+        Returns:
+            dict[str, MainTypes]: A dictionary containing the components of the step
+                definition, for use in Snakemake workflows.
+        """
+        return {
+            "run": self.run,
+            "input": self.input,
+            "params": self.params,
+            "output": self.output,
+        }
+
    +

    5. Create the Separate block definitions.

    +

    In this step, you'll define classes to handle the rendering of each code block required for a rule (step) to be executable in the target workflow language. Each of these classes will encapsulate the logic for converting parts of a workflow step into the target language format.

    +

    Example:

    +

    For the Snakemake workflow language, we will define:

    +
      +
    1. InputDefinition: Handles the input block and parameter block.
      2. +
    2. RunDefinition: Handles the run block.
      3. +
    3. OutputDefinition: Handles the output block.
      4. +
    +

    InputDefinition:

    +

    The InputDefinition class is responsible for rendering the inputs and parameters required for a Snakemake rule.

    +
    @define
+class InputDefinition:
+    """Represents input and parameter definitions block for a Snakemake-renderable workflow step.
+
+    Attributes:
+        inputs (List[str]): A list of input definitions.
+        params (List[str]): A list of parameter definitions.
+
+    Methods:
+        from_step(cls, step: Step) -> "InputDefinition": Constructs an InputDefinition
+            object from a Step object, extracting inputs and parameters and converting
+            them to Snakemake-compatible format.
+        render(self) -> dict[str, str]: Renders the input and parameter definitions
+            as a dictionary for use in Snakemake Input and Params blocks.
+    """
+
+    # As we already mention input and params block have similar generation
+    # So it made sence to encapsulate them into one Definition
+    inputs: list[str]
+    params: list[str]
+
+    @classmethod
+    def from_step(cls, step: Step) -> "InputDefinition":
+        """Constructs an InputDefinition object from a Step.
+
+        Args:
+            step (Step): The Step object from which input and parameter block definitions are
+                extracted.
+
+        Returns:
+            InputDefinition: An InputDefinition object.
+        """
+        params = []
+        inputs = []
+        # The keys represent the names of the arguments of the @tasks in our snakemake_workflow.py.
+        # The params represent the values.
+        for key, param in step.arguments.items():
+            # We check if the param is a reference.
+            # If it is then it's an input requirement for the rule to run, so we put it in the input block
+            if isinstance(param, Reference):
+                ref = ReferenceDefinition.from_reference(param).render().replace("-","_").replace("/out", ".output")
+                input = f"{key}=rules.{ref}.output_file"
+                inputs.append(input)
+                params.append(input + ",")
+            # If it's not - we put it in the params block for use in the RunDefinition
+            elif isinstance(param, Raw):
+                customized = f"{key}={to_snakemake_type(param)},"
+                params.append(customized)
+
+        # Since the params must be comma separated except the last one - we remove the last comma
+        if params:
+            params[len(params) - 1] = params[len(params) - 1].replace(",", "")
+
+        return cls(inputs=inputs, params=params)
+
+    def render(self) -> dict[str, list[str]]:
+        """Renders the input and parameter definitions as a dictionary.
+
+        Returns:
+            dict[str, list[MainTypes]]: A dictionary containing the input and parameter definitions,
+                for use in Snakemake Input and Params blocks.
+        """
+        return {"inputs": self.inputs, "params": self.params}
+
    +

    RunDefinition:

    +

    The RunDefinition class is responsible for rendering the run block, which contains the actual instructions for the task.

    +
    @define
+class RunDefinition:
+    # This is where we handle the execution of the task itself.
+    """Represents a Snakemake-renderable run block for a dewret workflow step.
+
+    Attributes:
+        method_name (str): The name of the method to be executed in the snakefile run block.
+        rel_import (str): The relative import path of the method.
+        args (List[str]): The arguments to be passed to the method.
+
+    Methods:
+        from_task(cls, task: Task) -> "RunDefinition": Constructs a RunDefinition
+            object from a Task object, extracting method information and arguments
+            from the task and converting them to Snakemake-compatible format.
+
+        render(self) -> list[str]: A list containing the import statement and the method
+            call statement, for use in Snakemake run block.
+    """
+
+    method_name: str
+    rel_import: str
+    args: list[str]
+
+    @classmethod
+    def from_task(cls, task: Task) -> "RunDefinition":
+        """Constructs a RunDefinition object from a Task.
+
+        Args:
+            task (Task): The Task object from which method information and arguments
+                are extracted.
+
+        Returns:
+            RunDefinition: A RunDefinition object containing the converted method
+                information and arguments.
+        """
+        # Since we can import our snakemake_workflow.py @tasks we need the relative path
+        relative_path = get_method_rel_path(task.target)
+        # If we need to make any customization to the import
+        rel_import = f"{relative_path}"
+
+        args = get_method_args(task.target)
+        signature = [
+            f"{param_name}=params.{param_name}"
+            for param_name in args.parameters.keys()
+        ]
+
+        return cls(method_name=task.name, rel_import=rel_import, args=signature)
+
+    def render(self) -> list[str]:
+        """Renders the run block as a list of strings.
+
+        Returns:
+            list[str]: A list containing the import statement and the method
+                call statement, for use in Snakemake run block.
+        """
+        signature = ", ".join(f"{arg}" for arg in self.args)
+        # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump
+        return [
+            f"import {self.rel_import}\n",
+            f"{self.rel_import}.{self.method_name}({signature})\n",
+        ]
+
    +

    OutputDefinition:

    +

    The OutputDefinition class is responsible for rendering the output block, which specifies the output files or results that indicate the rule has successfully completed.

    +
    @define
+class OutputDefinition:
+    """Represents the output definition block for a Snakemake-renderable workflow step.
+
+    Attributes:
+        output_file (str): The output file definition.
+
+    Methods:
+        from_step(cls, step: Step) -> "OutputDefinition": Constructs an OutputDefinition
+            object from a Step object, extracting and converting the output file definition
+            to Snakemake-compatible format.
+
+        render(self) -> list[str]: Renders the output definition as a list
+            suitable for use in Snakemake Output block.
+    """
+
+    output_file: str
+
+    @classmethod
+    def from_step(cls, step: Step) -> "OutputDefinition":
+        """Constructs an OutputDefinition object from a Step.
+
+        Args:
+            step (Step): The Step object from which the output file definition is extracted.
+
+        Returns:
+            OutputDefinition: An OutputDefinition object, for use in Snakemake Output block.
+        """
+        # Since snakemake commonly communicates using files.
+        # Output file must always be called - `output_file`
+        # Further code could be added to handled if it's a reference in case we want take care of multiple tasks writing to the same output file.
+        output_file = step.arguments["output_file"]
+        if isinstance(output_file, Raw):
+            args = to_snakemake_type(output_file)
+
+        return cls(output_file=args)
+
+    def render(self) -> list[str]:
+        """Renders the output definition as a list.
+
+        Returns:
+            list[str]: A list containing the output file definition, for use in a Snakemake Output block.
+        """
+        # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump
+        # It adds the new line to the output block
+        return [
+            f"output_file={self.output_file}",
+        ]
+
    +

    Integrate these block definitions into the StepDefinition class as demonstrated in Step 3. Each StepDefinition will use these block definitions to render the complete step in the target workflow language.

    +

    6. Helper methods.

    +

    In this step, you'll define helper methods that will assist you in converting workflow components into the target workflow language format. In our case these methods will handle type conversion, extracting method arguments, and computing relative paths.

    +

    Example:

    +

    We'll define the following helper methods for our Snakemake renderer:

    +
      +
    1. to_snakemake_type(param: Raw) -> str: Converts a raw type to a Snakemake-compatible Python type.
      2. +
    2. get_method_args(func: Lazy) -> inspect.Signature: Retrieves the argument names and types of a lazy-evaluatable function.
      3. +
    3. get_method_rel_path(func: Lazy) -> str: Computes the relative path of the module containing the given function.
      4. +
    +

    Type Conversion Helper:

    +
    # Basic types returned from dewret will look like this "str|valueOfParam".
+# We'll need to convert them.
+def to_Snakemake_type(param: Raw) -> str:
+    typ = str(param)
+    if typ.__contains__("str"):
+        return f'"{typ.replace("str|", "")}"'
+    elif typ.__contains__("bool"):
+        return typ.replace("bool|", "")
+    elif typ.__contains__("dict"):
+        return typ.replace("dict|", "")
+    elif typ.__contains__("list"):
+        return typ.replace("list|", "")
+    elif typ.__contains__("float"):
+        return typ.replace("float|", "")
+    elif typ.__contains__("int"):
+        return typ.replace("int|", "")
+    else:
+        raise TypeError(f"Cannot render complex type ({typ})")
+
    +

    Argument Extraction Helper:

    +
    # We need to get the signature of the method. 
+def get_method_args(func: Lazy) -> inspect.Signature:
+    args = inspect.signature(func)
+    return args
+
    +

    Relative Path Computation Helper:

    +
    # Computes the relative path
+def get_method_rel_path(func: Lazy) -> str:
+    source_file = inspect.getsourcefile(func)
+    if source_file:
+        relative_path = os.path.relpath(source_file, start=os.getcwd())
+        module_name = os.path.splitext(relative_path)[0].replace(os.path.sep, ".")
+
+    return module_name
+
    +

    Imports and custom types required in the SMK example:

    +
    import os
+import yaml
+import inspect
+import typing
+
+from attrs import define
+from dewret.utils import Raw, BasicType
+from dewret.workflow import Lazy
+from dewret.workflow import Reference, Workflow, Step, Task
+
+RawType = BasicType | list[str] | list["RawType"] | dict[str, "RawType"]
+
    +

    To run this example:

    +
      +
    1. Import the snakemake renderer into your @tasks file
      2. +
    2. There's an example in snakemake_tasks.py
      3. +
    3. Run it: +
      python snakemake_tasks.py
+
      4. +
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/docs/renderers/index.html b/docs/renderers/index.html new file mode 100644 index 00000000..b07b82d3 --- /dev/null +++ b/docs/renderers/index.html @@ -0,0 +1,793 @@ + + + + + + + + + + + + + + + + Renderers - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Renderers

    +

    Renderers are a function that takes a task, which can +be assumed to have a __workflow__ member of type Workflow, and return +a YAML-serializable nested dict structure.

    +

    CWL

    +

    The default renderer is for the Common Workflow Language. It implements a very small subset +of functionality, and is not yet strictly standards compliant. It assumes that all run +names can be interpreted in the context of the workflow module's global scope.

    +

    Custom

    +

    ...

    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/docs/workflows/index.html b/docs/workflows/index.html new file mode 100644 index 00000000..ce0ce6f0 --- /dev/null +++ b/docs/workflows/index.html @@ -0,0 +1,1639 @@ + + + + + + + + + + + + + + + + Workflows - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Workflows

    +

    Description

    +

    A dewret workflow is composed of one or more steps that may make use of both local and global parameters. Each step is defined by a dewret task that is created by using the @task() decorator, and each task may be used by multiple steps.

    +

    Setup

    +

    We can pull in dewret tools to produce CWL with a small number of imports.

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.tasks import task, construct
+>>> from dewret.workflow import param
+>>> from dewret.renderers.cwl import render
+
    +

    Dependencies

    +

    Specifying step interdependencies is possible by combining lazy-evaluated function +calls. The output series of steps is not guaranteed to be in order of execution.

    +

    Dewret hashes the parameters to identify and unify steps. This lets you do, for example:

    +
    graph TD
+    A[increment] --> B[double]
+    A[increment] --> C[mod10]
+    B[double] --> D[sum]
+    C[mod10] --> D[sum]
    +

    In code, this would be:

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> @task()
+... def increment(num: int) -> int:
+...     """Increment an integer."""
+...     return num + 1
+>>> 
+>>> @task()
+... def double(num: int) -> int:
+...     """Double an integer."""
+...     return 2 * num
+>>> 
+>>> @task()
+... def mod10(num: int) -> int:
+...     """Take num mod 10."""
+...     return num % 10
+>>> 
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...     """Add two integers."""
+...     return left + right
+>>>
+>>> result = sum(
+...     left=double(num=increment(num=23)),
+...     right=mod10(num=increment(num=23))
+... )
+>>> wkflw = construct(result, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  increment-1-num:
+    default: 23
+    label: num
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: sum-1/out
+    type: int
+steps:
+  double-1:
+    in:
+      num:
+        source: increment-1/out
+    out:
+    - out
+    run: double
+  increment-1:
+    in:
+      num:
+        source: increment-1-num
+    out:
+    - out
+    run: increment
+  mod10-1:
+    in:
+      num:
+        source: increment-1/out
+    out:
+    - out
+    run: mod10
+  sum-1:
+    in:
+      left:
+        source: double-1/out
+      right:
+        source: mod10-1/out
+    out:
+    - out
+    run: sum
+
    +

    Notice that the increment tasks appears twice in the CWL workflow definition, being referenced twice in the python code above. +This duplication can be avoided by explicitly indicating that the parameters are the same, with the param function.

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.workflow import param
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> @task()
+... def increment(num: int) -> int:
+...     """Increment an integer."""
+...     return num + 1
+>>> 
+>>> @task()
+... def double(num: int) -> int:
+...     """Double an integer."""
+...     return 2 * num
+>>> 
+>>> @task()
+... def mod10(num: int) -> int:
+...     """Take num mod 10."""
+...     return num % 10
+>>> 
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...     """Add two integers."""
+...     return left + right
+>>>
+>>> num = param("num", default=3)
+>>> result = sum(
+...     left=double(num=increment(num=num)),
+...     right=mod10(num=increment(num=num))
+... )
+>>> wkflw = construct(result, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  num:
+    default: 3
+    label: num
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: sum-1/out
+    type: int
+steps:
+  double-1:
+    in:
+      num:
+        source: increment-1/out
+    out:
+    - out
+    run: double
+  increment-1:
+    in:
+      num:
+        source: num
+    out:
+    - out
+    run: increment
+  mod10-1:
+    in:
+      num:
+        source: increment-1/out
+    out:
+    - out
+    run: mod10
+  sum-1:
+    in:
+      left:
+        source: double-1/out
+      right:
+        source: mod10-1/out
+    out:
+    - out
+    run: sum
+
    +

    Parameters

    +

    The tool will spot global variables that you have used when building your tasks, +and treat them as parameters. It will try to get the type from the typehint, or +the value that you have set it to. This only works for basic types (and dict/lists of +those).

    +

    While global variables are implicit input to the Python function note that:

    +
      +
    1. in CWL, they will be rendered as explicit global input to a step
      2. +
    2. as input, they are read-only, and must not be updated
      3. +
    +

    For example: +

    >>> import sys
+>>> import yaml
+>>> from dewret.workflow import param
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> INPUT_NUM = 3
+>>> @task()
+... def rotate(num: int) -> int:
+...    """Rotate an integer."""
+...    return (num + INPUT_NUM) % INPUT_NUM
+>>>
+>>> result = rotate(num=5)
+>>> wkflw = construct(result, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  INPUT_NUM:
+    default: 3
+    label: INPUT_NUM
+    type: int
+  rotate-1-num:
+    default: 5
+    label: num
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: rotate-1/out
+    type: int
+steps:
+  rotate-1:
+    in:
+      INPUT_NUM:
+        source: INPUT_NUM
+      num:
+        source: rotate-1-num
+    out:
+    - out
+    run: rotate
+

    +

    Nested tasks

    +

    When you wish to combine tasks together programmatically, +you can use nested tasks. These are run at render time, not +execution time. In other words, they do not appear in the +final graph, and so must only combine other tasks.

    +

    For example:

    +
    graph TD
+    A[rotate] --> B[rotate]
+    B[rotate] --> C[double_rotate]
    +

    As code:

    +

    >>> import sys
+>>> import yaml
+>>> from dewret.core import set_configuration
+>>> from dewret.tasks import task, construct, workflow
+>>> from dewret.renderers.cwl import render
+>>> INPUT_NUM = 3
+>>> @task()
+... def rotate(num: int) -> int:
+...     """Rotate an integer."""
+...     return (num + INPUT_NUM) % INPUT_NUM
+>>>
+>>> @workflow()
+... def double_rotate(num: int) -> int:
+...     """Rotate an integer twice."""
+...     return rotate(num=rotate(num=num))
+>>>
+>>> with set_configuration(flatten_all_nested=True):
+...     result = double_rotate(num=3)
+...     wkflw = construct(result, simplify_ids=True)
+...     cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  INPUT_NUM:
+    default: 3
+    label: INPUT_NUM
+    type: int
+  num:
+    default: 3
+    label: num
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: rotate-1/out
+    type: int
+steps:
+  rotate-1:
+    in:
+      INPUT_NUM:
+        source: INPUT_NUM
+      num:
+        source: rotate-2/out
+    out:
+    - out
+    run: rotate
+  rotate-2:
+    in:
+      INPUT_NUM:
+        source: INPUT_NUM
+      num:
+        source: num
+    out:
+    - out
+    run: rotate
+
    +Note that, as with all dewret calculations, only the steps +necessary to achieve the ultimate output are included in the final +graph. Therefore, nested tasks must return a step execution +(task that is being called) that forces any other calculations +you wish to happen. In other words, if a task in a +nested task does not have an impact on the return value, +it will disappear. +For example, the following code renders the same workflow as in the previous example:

    +
    @workflow()
+def double_rotate(num: int) -> int:
+   """Rotate an integer twice."""
+   unused_var = increment(num=num)
+   return rotate(num=rotate(num=num))
+
    +

    Step Output Fields

    +

    Each step, by default, is treated as having +a single result. However, we allow a mechanism +for specifying multiple fields, using attrs or dataclasses.

    +

    Where needed, fields can be accessed outside of tasks +by dot notation and dewret will map that access to a +specific output field in CWL.

    +

    Note that in the example below, shuffle is still +only seen once in the graph:

    +
    graph TD
+    A[shuffle] --> B[hearts]
+    A[shuffle] --> C[diamonds]
+    B[hearts] --> D[sum]
+    C[diamonds] --> D[sum]
    +

    As code:

    +
    >>> import sys
+>>> import yaml
+>>> from attrs import define
+>>> from numpy import random
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> @define
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> @task()
+... def shuffle(max_cards_per_suit: int) -> PackResult:
+...    """Fill a random pile from a card deck, suit by suit."""
+...    return PackResult(
+...        hearts=random.randint(max_cards_per_suit),
+...        clubs=random.randint(max_cards_per_suit),
+...        spades=random.randint(max_cards_per_suit),
+...        diamonds=random.randint(max_cards_per_suit)
+...    )
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>> red_total = sum(
+...     left=shuffle(max_cards_per_suit=13).hearts,
+...     right=shuffle(max_cards_per_suit=13).diamonds
+... )
+>>> wkflw = construct(red_total, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  shuffle-1-max_cards_per_suit:
+    default: 13
+    label: max_cards_per_suit
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: sum-1/out
+    type: int
+steps:
+  shuffle-1:
+    in:
+      max_cards_per_suit:
+        source: shuffle-1-max_cards_per_suit
+    out:
+      clubs:
+        label: clubs
+        type: int
+      diamonds:
+        label: diamonds
+        type: int
+      hearts:
+        label: hearts
+        type: int
+      spades:
+        label: spades
+        type: int
+    run: shuffle
+  sum-1:
+    in:
+      left:
+        source: shuffle-1/hearts
+      right:
+        source: shuffle-1/diamonds
+    out:
+    - out
+    run: sum
+
    +

    Here, we show the same example with dataclasses.

    +
    >>> import sys
+>>> import yaml
+>>> from dataclasses import dataclass
+>>> from numpy import random
+>>> from dewret.tasks import task, construct
+>>> from dewret.renderers.cwl import render
+>>> @dataclass
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> @task()
+... def shuffle(max_cards_per_suit: int) -> PackResult:
+...    """Fill a random pile from a card deck, suit by suit."""
+...    return PackResult(
+...        hearts=random.randint(max_cards_per_suit),
+...        clubs=random.randint(max_cards_per_suit),
+...        spades=random.randint(max_cards_per_suit),
+...        diamonds=random.randint(max_cards_per_suit)
+...    )
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>>
+>>> red_total = sum(
+...     left=shuffle(max_cards_per_suit=13).hearts,
+...     right=shuffle(max_cards_per_suit=13).diamonds
+... )
+>>> wkflw = construct(red_total, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  shuffle-1-max_cards_per_suit:
+    default: 13
+    label: max_cards_per_suit
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: sum-1/out
+    type: int
+steps:
+  shuffle-1:
+    in:
+      max_cards_per_suit:
+        source: shuffle-1-max_cards_per_suit
+    out:
+      clubs:
+        label: clubs
+        type: int
+      diamonds:
+        label: diamonds
+        type: int
+      hearts:
+        label: hearts
+        type: int
+      spades:
+        label: spades
+        type: int
+    run: shuffle
+  sum-1:
+    in:
+      left:
+        source: shuffle-1/hearts
+      right:
+        source: shuffle-1/diamonds
+    out:
+    - out
+    run: sum
+
    +

    Subworkflow

    +

    A special form of nested task is available to help divide up +more complex workflows: the subworkflow. By wrapping logic in subflows, +dewret will produce multiple output workflows that reference each other.

    +
    >>> import sys
+>>> import yaml
+>>> from attrs import define
+>>> from numpy import random
+>>> from dewret.tasks import task, construct, workflow
+>>> from dewret.renderers.cwl import render
+>>> @define
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>>
+>>> @task()
+... def shuffle(max_cards_per_suit: int) -> PackResult:
+...    """Fill a random pile from a card deck, suit by suit."""
+...    return PackResult(
+...        hearts=random.randint(max_cards_per_suit),
+...        clubs=random.randint(max_cards_per_suit),
+...        spades=random.randint(max_cards_per_suit),
+...        diamonds=random.randint(max_cards_per_suit)
+...    )
+>>> @workflow()
+... def red_total() -> int:
+...     return sum(
+...         left=shuffle(max_cards_per_suit=13).hearts,
+...         right=shuffle(max_cards_per_suit=13).diamonds
+...     )
+>>> @workflow()
+... def black_total() -> int:
+...     return sum(
+...         left=shuffle(max_cards_per_suit=13).spades,
+...         right=shuffle(max_cards_per_suit=13).clubs
+...     )
+>>> total = sum(left=red_total(), right=black_total())
+>>> wkflw = construct(total, simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs: {}
+outputs:
+  out:
+    label: out
+    outputSource: sum-1/out
+    type: int
+steps:
+  black_total-1:
+    in: {}
+    out:
+    - out
+    run: black_total
+  red_total-1:
+    in: {}
+    out:
+    - out
+    run: red_total
+  sum-1:
+    in:
+      left:
+        source: red_total-1/out
+      right:
+        source: black_total-1/out
+    out:
+    - out
+    run: sum
+
    +

    As we have used subworkflow to wrap the colour totals, the outer workflow +contains references to them only. The subworkflows are now returned by render +as a second term.

    +
    >>> import sys
+>>> import yaml
+>>> from attrs import define
+>>> from numpy import random
+>>> from dewret.tasks import task, construct, workflow
+>>> from dewret.renderers.cwl import render
+>>> @define
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> @task()
+... def shuffle(max_cards_per_suit: int) -> PackResult:
+...    """Fill a random pile from a card deck, suit by suit."""
+...    return PackResult(
+...        hearts=random.randint(max_cards_per_suit),
+...        clubs=random.randint(max_cards_per_suit),
+...        spades=random.randint(max_cards_per_suit),
+...        diamonds=random.randint(max_cards_per_suit)
+...    )
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>>
+>>> @workflow()
+... def red_total() -> int:
+...     return sum(
+...         left=shuffle(max_cards_per_suit=13).hearts,
+...         right=shuffle(max_cards_per_suit=13).diamonds
+...     )
+>>> @workflow()
+... def black_total() -> int:
+...     return sum(
+...         left=shuffle(max_cards_per_suit=13).spades,
+...         right=shuffle(max_cards_per_suit=13).clubs
+...     )
+>>> total = sum(left=red_total(), right=black_total())
+>>> wkflw = construct(total, simplify_ids=True)
+>>> cwl = render(wkflw)
+>>> yaml.dump(cwl["red_total-1"], sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs: {}
+outputs:
+  out:
+    label: out
+    outputSource: sum-1-1/out
+    type: int
+steps:
+  shuffle-1-1:
+    in:
+      max_cards_per_suit:
+        default: 13
+    out:
+      clubs:
+        label: clubs
+        type: int
+      diamonds:
+        label: diamonds
+        type: int
+      hearts:
+        label: hearts
+        type: int
+      spades:
+        label: spades
+        type: int
+    run: shuffle
+  sum-1-1:
+    in:
+      left:
+        source: shuffle-1-1/hearts
+      right:
+        source: shuffle-1-1/diamonds
+    out:
+    - out
+    run: sum
+
    +

    Input Factories

    +

    Sometimes we want to take complex Python input, not just raw types. +Not all serialization support this, but the factory function lets us +wrap a simple call, usually a constructor, that takes only raw arguments. +This can then rendered as either a step or a parameter depending on whether +the chosen renderer has the capability.

    +

    Below is the default output, treating Pack as a task.

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.tasks import workflow, factory, workflow, construct, task
+>>> from attrs import define
+>>> from dewret.renderers.cwl import render
+>>> @define
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> Pack = factory(PackResult)
+>>>
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>>
+>>> @workflow()
+... def black_total(pack: PackResult) -> int:
+...     return sum(
+...         left=pack.spades,
+...         right=pack.clubs
+...     )
+>>> pack = Pack(hearts=13, spades=13, diamonds=13, clubs=13)
+>>> wkflw = construct(black_total(pack=pack), simplify_ids=True)
+>>> cwl = render(wkflw)["__root__"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  PackResult-1-clubs:
+    default: 13
+    label: clubs
+    type: int
+  PackResult-1-diamonds:
+    default: 13
+    label: diamonds
+    type: int
+  PackResult-1-hearts:
+    default: 13
+    label: hearts
+    type: int
+  PackResult-1-spades:
+    default: 13
+    label: spades
+    type: int
+outputs:
+  out:
+    label: out
+    outputSource: black_total-1/out
+    type: int
+steps:
+  PackResult-1:
+    in:
+      clubs:
+        source: PackResult-1-clubs
+      diamonds:
+        source: PackResult-1-diamonds
+      hearts:
+        source: PackResult-1-hearts
+      spades:
+        source: PackResult-1-spades
+    out:
+      clubs:
+        label: clubs
+        type: int
+      diamonds:
+        label: diamonds
+        type: int
+      hearts:
+        label: hearts
+        type: int
+      spades:
+        label: spades
+        type: int
+    run: PackResult
+  black_total-1:
+    in:
+      pack:
+        source: PackResult-1/out
+    out:
+    - out
+    run: black_total
+
    +

    The CWL renderer is also able to treat pack as a parameter, if complex +types are allowed.

    +
    >>> import sys
+>>> import yaml
+>>> from dewret.tasks import task, factory, workflow, construct
+>>> from attrs import define
+>>> from dewret.renderers.cwl import render
+>>> @define
+... class PackResult:
+...     hearts: int
+...     clubs: int
+...     spades: int
+...     diamonds: int
+>>>
+>>> Pack = factory(PackResult)
+>>> @task()
+... def sum(left: int, right: int) -> int:
+...    return left + right
+>>>
+>>> @workflow()
+... def black_total(pack: PackResult) -> int:
+...     return sum(
+...         left=pack.spades,
+...         right=pack.clubs
+...     )
+>>> pack = Pack(hearts=13, spades=13, diamonds=13, clubs=13)
+>>> wkflw = construct(black_total(pack=pack), simplify_ids=True)
+>>> cwl = render(wkflw, allow_complex_types=True, factories_as_params=True)["black_total-1"]
+>>> yaml.dump(cwl, sys.stdout, indent=2)
+class: Workflow
+cwlVersion: 1.2
+inputs:
+  pack:
+    label: pack
+    type: record
+outputs:
+  out:
+    label: out
+    outputSource: sum-1-1/out
+    type: int
+steps:
+  sum-1-1:
+    in:
+      left:
+        source: pack/spades
+      right:
+        source: pack/clubs
+    out:
+    - out
+    run: sum
+
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/index.html b/index.html new file mode 100644 index 00000000..e2abbbeb --- /dev/null +++ b/index.html @@ -0,0 +1,790 @@ + + + + + + + + + + + + + + + + dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    dewret

    +

    DEclarative Workflow REndering Tool

    +

    Pron: durr-it, like "durable"

    +

    Introduction

    +

    Dewret allows certain workflows written in a dynamic +style to be rendered to a static representation.

    +

    Advantages of doing so include:

    +
      +
    • git-versionable workflows: while code can be versioned, the changes of a dynamic workflow + do not necessarily clearly correspond to changes in the executed workflow. This maintains + a precise trackable history.
      • +
    • plan and play: the workflow can be rapidly iterated, analysed and optimized before it + is sent for real execution on expensive or restricted HPC hardware.
      • +
    • optimization: creating the workflow explicitly opens up possibilities for static analysis + and refactoring before real execution.
      • +
    • debugging: a number of classes of workflow planning bugs will not appear until late + in a simulation run that might take days or weeks. This catches them before startup.
      • +
    • continuous integration and testing: complex dynamic workflows can be rapidly sense-checked + in CI without needing all the hardware and internal algorithms present to run them.
      • +
    +

    Documentation

    +

    For further information, see the documentation.

    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/annotations/index.html b/reference/dewret/annotations/index.html new file mode 100644 index 00000000..a7d1ea48 --- /dev/null +++ b/reference/dewret/annotations/index.html @@ -0,0 +1,1106 @@ + + + + + + + + + + + + + + + + Annotations - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.annotations

    +

    Tooling for managing annotations.

    +

    Provides FunctionAnalyser, a toolkit that takes a Callable and can interrogate it +for annotations, with some intelligent searching beyond the obvious location.

    +

    Variables

    +
    AtRender
+
    +
    Fixed
+
    +
    T
+
    +

    Classes

    +

    FunctionAnalyser

    +
    class FunctionAnalyser(
+    fn: Callable[..., Any]
+)
+
    +

    Convenience class for analysing a function with reduced duplication of effort.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    _fnNonethe wrapped callableNone
    _annotationsNonestored annotations for the function.None
    +

    Instance variables

    +
    free_vars
+
    +

    Get the free variables for this Callable.

    +
    globals
+
    +

    Get the globals for this Callable.

    +
    return_type
+
    +

    Return type of the callable.

    +

    Returns: expected type of the return value.

    +

    Methods

    +

    argument_has

    +
    def argument_has(
+    self,
+    arg: str,
+    annotation: type,
+    exhaustive: bool = False
+) -> bool
+
    +

    Check if the named argument has the given annotation.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    argNoneargument to retrieve.None
    annotationNoneAnnotated to search for.None
    exhaustiveNonewhether to check the globals and other modules.None
    +

    get_all_imported_names

    +
    def get_all_imported_names(
+    self
+) -> dict[str, tuple[module, str]]
+
    +

    Find all of the annotations that were imported into this module.

    +

    get_all_module_names

    +
    def get_all_module_names(
+    self
+) -> dict[str, typing.Any]
+
    +

    Find all of the annotations within this module.

    +

    get_argument_annotation

    +
    def get_argument_annotation(
+    self,
+    arg: str,
+    exhaustive: bool = False
+) -> Any
+
    +

    Retrieve the annotations for this argument.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    argNonename of the argument.None
    exhaustiveNoneTrue if we should search outside the function itself, into the module globals, and into imported modules.None
    +

    is_at_construct_arg

    +
    def is_at_construct_arg(
+    self,
+    arg: str,
+    exhaustive: bool = False
+) -> bool
+
    +

    Convience function to check for AtConstruct, wrapping FunctionAnalyser.argument_has.

    +

    with_new_globals

    +
    def with_new_globals(
+    self,
+    new_globals: dict[str, typing.Any]
+) -> Callable[..., Any]
+
    +

    Create a Callable that will run the current Callable with new globals.

    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/backends/backend_dask/index.html b/reference/dewret/backends/backend_dask/index.html new file mode 100644 index 00000000..d9078683 --- /dev/null +++ b/reference/dewret/backends/backend_dask/index.html @@ -0,0 +1,1220 @@ + + + + + + + + + + + + + + + + Backend Dask - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.backends.backend_dask

    +

    Dask backend.

    +

    Lazy-evaluation via dask.delayed.

    +

    Variables

    +
    config
+
    +

    Functions

    +

    is_lazy

    +
    def is_lazy(
+    task: Any
+) -> bool
+
    +

    Checks if a task is really a lazy-evaluated function for this backend.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonesuspected lazy-evaluated function.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneTrue if so, False otherwise.
    +

    lazy

    +
    def lazy(
+    obj='__no__default__',
+    name=None,
+    pure=None,
+    nout=None,
+    traverse=True
+)
+
    +

    Wraps a function or object to produce a Delayed.

    +

    Delayed objects act as proxies for the object they wrap, but all +operations on them are done lazily by building up a dask graph internally.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    objobjectThe function or object to wrapNone
    nameDask keyThe key to use in the underlying graph for the wrapped object. Defaults
    to hashing content. Note that this only affects the name of the object
    wrapped by this call to delayed, and not the output of delayed
    function calls - for that use dask_key_name= as described below.

    .. note::

    Because this name is used as the key in task graphs, you should
    ensure that it uniquely identifies obj. If you'd like to provide
    a descriptive name that is still unique, combine the descriptive name
    with :func:dask.base.tokenize of the array_like. See
    :ref:graphs for more.    		s
    pureboolIndicates whether calling the resulting Delayed object is a pure
    operation. If True, arguments to the call are hashed to produce
    deterministic keys. If not provided, the default is to check the global
    delayed_pure setting, and fallback to False if unset.    		to
    noutintThe number of outputs returned from calling the resulting Delayed
    object. If provided, the Delayed output of the call can be iterated
    into nout objects, allowing for unpacking of results. By default
    iteration over Delayed objects will error. Note, that nout=1
    expects obj to return a tuple of length 1, and consequently for
    nout=0, obj should return an empty tuple.    		iteration
    traverseboolBy default dask traverses builtin python collections looking for dask
    objects passed to delayed. For large collections this can be
    expensive. If obj doesn't contain any dask objects, set
    traverse=False to avoid doing this traversal.    		dask
    +

    run

    +
    def run(
+    workflow: dewret.workflow.Workflow | None,
+    task: dewret.workflow.Lazy | list[dewret.workflow.Lazy] | tuple[dewret.workflow.Lazy],
+    thread_pool: concurrent.futures.thread.ThreadPoolExecutor | None = None,
+    **kwargs: Any
+) -> Any
+
    +

    Execute a task as the output of a workflow.

    +

    Runs a task with dask.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneWorkflow in which to record the execution.None
    taskNonedask.delayed function, wrapped by dewret, that we wish to compute.None
    thread_poolNonecustom thread pool for executing workflows, copies in correct values for contextvars to each thread before they are accessed by a dask worker.None
    **kwargsNoneany configuration arguments for this backend.None
    +

    unwrap

    +
    def unwrap(
+    task: dewret.workflow.Lazy
+) -> collections.abc.Callable[..., typing.Any]
+
    +

    Unwraps a lazy-evaluated function to get the function.

    +

    In recent dask (>=2024.3) this works with inspect.wraps, but earlier +versions do not have the __wrapped__ property.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonetask to be unwrapped.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneOriginal target.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    RuntimeErrorif the task is not a wrapped function.
    +

    Classes

    +

    Delayed

    +
    class Delayed(
+    *args,
+    **kwargs
+)
+
    +

    Description of a dask delayed.

    +

    Since dask.delayed does not have a hintable type, this +stands in its place, making sure that all the features of a +dask.delayed are available.

    +

    More info: https://github.com/dask/dask/issues/7779

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Methods

    +

    compute

    +
    def compute(
+    self,
+    __workflow__: dewret.workflow.Workflow | None
+) -> dewret.workflow.StepReference[typing.Any]
+
    +

    Evaluate this dask.delayed.

    +

    Evaluate a delayed (dask lazy-evaluated) function. dewret +will have replaced it with a wrapper that expects a Workflow +and all arguments will already be known to the wrapped delayed +so the signature here is simple.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneWorkflow that this is tied to, if applicable.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReference to the final output step.
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/backends/index.html b/reference/dewret/backends/index.html new file mode 100644 index 00000000..ff943767 --- /dev/null +++ b/reference/dewret/backends/index.html @@ -0,0 +1,783 @@ + + + + + + + + + + + + + + + + Index - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.backends

    +

    Backends for supplying lazy-evaluation.

    +

    By default, we use dask, but it is possible to extend this functionality +as the behaviour is encapsulated within these modules.

    +

    Sub-modules

    + + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/core/index.html b/reference/dewret/core/index.html new file mode 100644 index 00000000..d505d081 --- /dev/null +++ b/reference/dewret/core/index.html @@ -0,0 +1,8678 @@ + + + + + + + + + + + + + + + + Core - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.core

    +

    Base classes that need to be available everywhere.

    +

    Mainly tooling around configuration, protocols and superclasses for References +and WorkflowComponents, that are concretized elsewhere.

    +

    Variables

    +
    BasicType
+
    +
    CONFIGURATION
+
    +
    ExprType
+
    +
    FirmType
+
    +
    RawType
+
    +
    RenderConfiguration
+
    +
    T
+
    +
    U
+
    +

    Functions

    +

    default_construct_config

    +
    def default_construct_config(
+    
+) -> dewret.core.ConstructConfiguration
+
    +

    Gets the default construct-time configuration.

    +

    This is the primary mechanism for configuring dewret internals, so these defaults +should be carefully chosen and, if they change, that likely has an impact on backwards compatibility +from a SemVer perspective.

    +

    Returns: configuration dictionary with default construct values.

    +

    default_renderer_config

    +
    def default_renderer_config(
+    
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Gets the default renderer configuration.

    +

    This may be called frequently, but is cached so note that any changes to the +wrapped config function will not be reflected during the process.

    +

    It is a light wrapper for default_config in the supplier renderer module.

    +

    Returns: the default configuration dict for the chosen renderer.

    +

    get_configuration

    +
    def get_configuration(
+    key: str
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+
    +

    Retrieve the configuration or (silently) return the default.

    +

    Helps avoid a proliferation of set_configuration calls by not erroring if it has not been called. +However, the cost is that the user may accidentally put configuration-affected logic outside a +set_configuration call and be surprised that the behaviour is inexplicibly not as expected.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    keyNoneconfiguration key to retrieve.None
    +

    get_render_configuration

    +
    def get_render_configuration(
+    key: str
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+
    +

    Retrieve configuration for the active renderer.

    +

    Finds the current user-set configuration, defaulting back to the chosen renderer module's declared +defaults.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    keyNoneconfiguration key to retrieve.None
    +

    set_configuration

    +
    def set_configuration(
+    **kwargs: *<class 'dewret.core.ConstructConfigurationTypedDict'>
+) -> Iterator[_contextvars.ContextVar[dewret.core.GlobalConfiguration]]
+
    +

    Sets the construct-time configuration.

    +

    This is a context manager, so that a setting can be temporarily overridden and automatically restored.

    +

    set_render_configuration

    +
    def set_render_configuration(
+    kwargs: dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+) -> Iterator[_contextvars.ContextVar[dewret.core.GlobalConfiguration]]
+
    +

    Sets the render-time configuration.

    +

    This is a context manager, so that a setting can be temporarily overridden and automatically restored.

    +

    Returns: the yielded global configuration ContextVar.

    +

    strip_annotations

    +
    def strip_annotations(
+    parent_type: type
+) -> tuple[type, tuple[str]]
+
    +

    Discovers and removes annotations from a parent type.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    parent_typeNonea type, possibly Annotated.None
    +

    Classes

    +

    BaseRenderModule

    +
    class BaseRenderModule(
+    *args,
+    **kwargs
+)
+
    +

    Common routines for all renderer modules.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Descendants

    +
      +
    • dewret.core.RawRenderModule
      • +
    • dewret.core.StructuredRenderModule
      • +
    +

    Static methods

    +

    default_config

    +
    def default_config(
+    
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Retrieve default settings.

    +

    These will not change during execution, but can be overridden by dewret.core.set_render_configuration.

    +

    Returns: a static, serializable dict.

    +

    ConstructConfiguration

    +
    class ConstructConfiguration(
+    flatten_all_nested: bool = False,
+    allow_positional_args: bool = False,
+    allow_plain_dict_fields: bool = False,
+    field_separator: str = '/',
+    field_index_types: str = 'int',
+    simplify_ids: bool = False
+)
+
    +

    Basic configuration of the construction process.

    +

    Holds configuration that may be relevant to construst(...) calls or, realistically, +anything prior to rendering. It should hold generic configuration that is renderer-independent.

    +

    Instance variables

    +
    allow_plain_dict_fields
+
    +
    allow_positional_args
+
    +
    field_index_types
+
    +
    field_separator
+
    +
    flatten_all_nested
+
    +
    simplify_ids
+
    +

    ConstructConfigurationTypedDict

    +
    class ConstructConfigurationTypedDict(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Basic configuration of the construction process.

    +

    Holds configuration that may be relevant to construst(...) calls or, realistically, +anything prior to rendering. It should hold generic configuration that is renderer-independent.

    +

    THIS MUST BE KEPT IDENTICAL TO ConstructConfiguration.

    +

    Ancestors (in MRO)

    +
      +
    • builtins.dict
      • +
    +

    Methods

    +

    clear

    +
    def clear(
+    ...
+)
+
    +

    D.clear() -> None. Remove all items from D.

    +

    copy

    +
    def copy(
+    ...
+)
+
    +

    D.copy() -> a shallow copy of D

    +

    fromkeys

    +
    def fromkeys(
+    iterable,
+    value=None,
+    /
+)
+
    +

    Create a new dictionary with keys from iterable and values set to value.

    +

    get

    +
    def get(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Return the value for key if key is in the dictionary, else default.

    +

    items

    +
    def items(
+    ...
+)
+
    +

    D.items() -> a set-like object providing a view on D's items

    +

    keys

    +
    def keys(
+    ...
+)
+
    +

    D.keys() -> a set-like object providing a view on D's keys

    +

    pop

    +
    def pop(
+    ...
+)
+
    +

    D.pop(k[,d]) -> v, remove specified key and return the corresponding value.

    +

    If the key is not found, return the default if given; otherwise, +raise a KeyError.

    +

    popitem

    +
    def popitem(
+    self,
+    /
+)
+
    +

    Remove and return a (key, value) pair as a 2-tuple.

    +

    Pairs are returned in LIFO (last-in, first-out) order. +Raises KeyError if the dict is empty.

    +

    setdefault

    +
    def setdefault(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Insert key with a value of default if key is not in the dictionary.

    +

    Return the value for key if key is in the dictionary, else default.

    +

    update

    +
    def update(
+    ...
+)
+
    +

    D.update([E, ]**F) -> None. Update D from dict/iterable E and F.

    +

    If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k]

    +

    values

    +
    def values(
+    ...
+)
+
    +

    D.values() -> an object providing a view on D's values

    +

    GlobalConfiguration

    +
    class GlobalConfiguration(
+    construct: dewret.core.ConstructConfiguration,
+    render: dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+)
+
    +

    Overall configuration structure.

    +

    Having a single configuration dict allows us to manage only one ContextVar.

    +

    Instance variables

    +
    construct
+
    +
    render
+
    +

    IterableMixin

    +
    class IterableMixin(
+    typ: type[~U] | None = None,
+    **kwargs: Any
+)
+
    +

    Functionality for iterating over references to give new references.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.Reference
      • +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.IterableParameterReference
      • +
    • dewret.workflow.IterableStepReference
      • +
    +

    Class variables

    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    IteratedGenerator

    +
    class IteratedGenerator(
+    to_wrap: dewret.core.Reference[~U]
+)
+
    +

    Sentinel value for capturing that an iteration has occured without performing it.

    +

    Allows us to lazily evaluate a loop, for instance, in the renderer. This may be relevant +if the renderer wishes to postpone iteration to runtime, and simply record it is required, +rather than evaluating the iterator.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Generic
      • +
    +

    Raw

    +
    class Raw(
+    value: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+)
+
    +

    Value object for any raw types.

    +

    This is able to hash raw types consistently and provides +a single type for validating type-consistency.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonethe real value, e.g. a str, int, ...None
    +

    RawRenderModule

    +
    class RawRenderModule(
+    *args,
+    **kwargs
+)
+
    +

    Render module that returns raw text.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.BaseRenderModule
      • +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Static methods

    +

    default_config

    +
    def default_config(
+    
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Retrieve default settings.

    +

    These will not change during execution, but can be overridden by dewret.core.set_render_configuration.

    +

    Returns: a static, serializable dict.

    +

    Methods

    +

    render_raw

    +
    def render_raw(
+    self,
+    workflow: dewret.core.WorkflowProtocol,
+    **kwargs: dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+) -> dict[str, str]
+
    +

    Turn a workflow into flat strings.

    +

    Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least.

    +

    Reference

    +
    class Reference(
+    *args: Any,
+    typ: type[~U] | None = None,
+    **kwargs: Any
+)
+
    +

    Superclass for all symbolic references to values.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.core.IterableMixin
      • +
    • dewret.workflow.ParameterReference
      • +
    • dewret.workflow.StepReference
      • +
    +

    Class variables

    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    RenderCall

    +
    class RenderCall(
+    *args,
+    **kwargs
+)
+
    +

    Callable that will render out workflow(s).

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    StructuredRenderModule

    +
    class StructuredRenderModule(
+    *args,
+    **kwargs
+)
+
    +

    Render module that returns JSON/YAML-serializable structures.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.BaseRenderModule
      • +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Static methods

    +

    default_config

    +
    def default_config(
+    
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Retrieve default settings.

    +

    These will not change during execution, but can be overridden by dewret.core.set_render_configuration.

    +

    Returns: a static, serializable dict.

    +

    Methods

    +

    render

    +
    def render(
+    self,
+    workflow: dewret.core.WorkflowProtocol,
+    **kwargs: dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+) -> dict[str, dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]]
+
    +

    Turn a workflow into a serializable structure.

    +

    Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least.

    +

    UnevaluatableError

    +
    class UnevaluatableError(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Signposts that a user has tried to treat a reference as the real (runtime) value.

    +

    For example, by comparing to a concrete integer or value, etc.

    +

    Ancestors (in MRO)

    +
      +
    • builtins.Exception
      • +
    • builtins.BaseException
      • +
    +

    Class variables

    +
    args
+
    +

    Methods

    +

    add_note

    +
    def add_note(
+    ...
+)
+
    +

    Exception.add_note(note) --

    +

    add a note to the exception

    +

    with_traceback

    +
    def with_traceback(
+    ...
+)
+
    +

    Exception.with_traceback(tb) --

    +

    set self.traceback to tb and return self.

    +

    WorkflowComponent

    +
    class WorkflowComponent(
+    *args: Any,
+    workflow: dewret.core.WorkflowProtocol,
+    **kwargs: Any
+)
+
    +

    Base class for anything directly tied to an individual Workflow.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNonethe Workflow that this is tied to.None
    +

    Descendants

    +
      +
    • dewret.core.Reference
      • +
    • dewret.workflow.BaseStep
      • +
    • dewret.workflow.ParameterReference
      • +
    +

    WorkflowProtocol

    +
    class WorkflowProtocol(
+    *args,
+    **kwargs
+)
+
    +

    Expected structure for a workflow.

    +

    We do not expect various workflow implementations, but this allows us to define the +interface expected by the core classes.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Methods

    +

    remap

    +
    def remap(
+    self,
+    name: str
+) -> str
+
    +

    Perform any name-changing for steps, etc. in the workflow.

    +

    This enables, for example, simplifying all the IDs to an integer sequence.

    +

    Returns: remapped name.

    +

    set_result

    +
    def set_result(
+    self,
+    result: sympy.core.basic.Basic | list[sympy.core.basic.Basic] | tuple[sympy.core.basic.Basic]
+) -> None
+
    +

    Set the step that should produce a result for the overall workflow.

    +

    simplify_ids

    +
    def simplify_ids(
+    self,
+    infix: list[str] | None = None
+) -> None
+
    +

    Drop the non-human-readable IDs if possible, in favour of integer sequences.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    infixNoneany inherited intermediary identifiers, to allow nesting, or None.None
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/index.html b/reference/dewret/index.html new file mode 100644 index 00000000..7b5d6ebc --- /dev/null +++ b/reference/dewret/index.html @@ -0,0 +1,788 @@ + + + + + + + + + + + + + + + + Index - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    + +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/render/index.html b/reference/dewret/render/index.html new file mode 100644 index 00000000..208f8fdf --- /dev/null +++ b/reference/dewret/render/index.html @@ -0,0 +1,982 @@ + + + + + + + + + + + + + + + + Render - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.render

    +

    Utilities for building renderers.

    +

    Provides the routines for calling varied renderers in a standard way, and for +renderers to reuse to build up their own functionality.

    +

    Variables

    +
    T
+
    +

    Functions

    +

    base_render

    +
    def base_render(
+    workflow: dewret.workflow.Workflow,
+    build_cb: Callable[[dewret.workflow.Workflow], ~T]
+) -> dict[str, ~T]
+
    +

    Render to a dict-like structure.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneworkflow to evaluate result.None
    build_cbNonea callback to call for each workflow found.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    get_render_method

    +
    def get_render_method(
+    renderer: pathlib.Path | dewret.core.RawRenderModule | dewret.core.StructuredRenderModule,
+    pretty: bool = False
+) -> dewret.core.RenderCall
+
    +

    Create a ready-made callable to render the workflow that is appropriate for the renderer module.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    rendererNonea module or path to a module.None
    prettyNonewhether the renderer should attempt to YAML-format the output (if relevant).None
    +

    structured_to_raw

    +
    def structured_to_raw(
+    rendered: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'],
+    pretty: bool = False
+) -> str
+
    +

    Serialize a serializable structure to a string.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    renderedNonea possibly-nested, static basic Python structure.None
    prettyNonewhether to attempt YAML dumping with an indent of 2.None
    +

    write_rendered_output

    +
    def write_rendered_output(
+    rendered: dict[str, str] | dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']],
+    output: str,
+    opener: Callable[[str, str], ContextManager[IO[Any]]]
+) -> None
+
    +

    Utility function to handle writing rendered output to file or stdout.

    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/renderers/cwl/index.html b/reference/dewret/renderers/cwl/index.html new file mode 100644 index 00000000..033fd9e4 --- /dev/null +++ b/reference/dewret/renderers/cwl/index.html @@ -0,0 +1,3282 @@ + + + + + + + + + + + + + + + + Cwl - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.renderers.cwl

    +

    CWL Renderer.

    +

    Outputs a Common Workflow Language representation of the +current workflow.

    +

    Variables

    +
    InputSchemaType
+
    +

    Functions

    +

    cwl_type_from_value

    +
    def cwl_type_from_value(
+    label: str,
+    val: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | dewret.utils.Unset
+) -> dewret.renderers.cwl.CommandInputSchema
+
    +

    Find a CWL type for a given (possibly Unset) value.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    labelNonethe label for the variable being checked to prefill the input def and improve debugging info.None
    valNonea raw Python variable or an unset variable.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneInput schema type.
    +

    default_config

    +
    def default_config(
+    
+) -> dewret.renderers.cwl.CWLRendererConfiguration
+
    +

    Default configuration for this renderer.

    +

    This is a hook-like call to give a configuration dict that this renderer +will respect, and sets any necessary default values.

    +

    Returns: a dict with (preferably) raw type structures to enable easy setting + from YAML/JSON.

    +

    raw_to_command_input_schema

    +
    def raw_to_command_input_schema(
+    label: str,
+    value: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | dewret.utils.Unset
+) -> str | dewret.renderers.cwl.CommandInputSchema | list[str] | list['InputSchemaType'] | dict[str, 'str | InputSchemaType']
+
    +

    Infer the CWL input structure for this value.

    +

    Inspects the value, to work out an appropriate structure +describing it in CWL.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    labelNonename of the variable.None
    valueNonebasic-typed variable from which to build structure.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneStructure used to define (possibly compound) basic types for input.
    +

    render

    +
    def render(
+    workflow: dewret.workflow.Workflow,
+    **kwargs: *<class 'dewret.renderers.cwl.CWLRendererConfiguration'>
+) -> dict[str, dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]]
+
    +

    Render to a dict-like structure.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneworkflow to evaluate result.None
    **kwargsNoneadditional configuration arguments - these should match CWLRendererConfiguration.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    render_expression

    +
    def render_expression(
+    ref: Any
+) -> 'ReferenceDefinition'
+
    +

    Turn a rich (sympy) expression into a CWL JS expression.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    refNonea structure whose elements are all string-renderable or sympy Basic.None
    +

    to_cwl_type

    +
    def to_cwl_type(
+    label: str,
+    typ: type
+) -> dewret.renderers.cwl.CommandInputSchema
+
    +

    Map Python types to CWL types.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    labelNonethe label for the variable being checked to prefill the input def and improve debugging info.None
    typNonea Python basic type.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneCWL specification type dict.
    +

    to_name

    +
    def to_name(
+    result: dewret.core.Reference[typing.Any]
+) -> str
+
    +

    Take a reference and get a name representing it.

    +

    The primary purpose of this method is to deal with the case where a reference is to the +whole result, as we always put this into an imagined out field for CWL consistency.

    +

    Returns: the name of the reference, including any field portion, appending an "out" fieldname if none.

    +

    to_output_schema

    +
    def to_output_schema(
+    label: str,
+    typ: type[str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | attr.AttrsInstance | dewret.utils.DataclassProtocol],
+    output_source: str | None = None
+) -> dewret.renderers.cwl.CommandOutputSchema
+
    +

    Turn a step's output into an output schema.

    +

    Takes a source, type and label and provides a description for CWL.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    labelNonename of this field.None
    typNoneeither a basic type, compound of basic types, or a TypedDict representing a pre-defined result structure.None
    output_sourceNoneif provided, a CWL step result reference to input here.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneCWL CommandOutputSchema-like structure for embedding into an outputs block
    +

    with_field

    +
    def with_field(
+    result: Any
+) -> str
+
    +

    Get a string representing any 'field' suffix of a value.

    +

    This only makes sense in the context of a Reference, which can represent +a deep reference with a known variable (parameter or step result, say) using +its __field__ attribute. Defaults to "out" as this produces compliant CWL +where every output has a "fieldname".

    +

    Returns: a string representation of the field portion of the passed value or "out".

    +

    with_type

    +
    def with_type(
+    result: Any
+) -> type | typing.Any
+
    +

    Get a Python type from a value.

    +

    Does so either by using its __type__ field (for example, for References) +or if unavailable, using type().

    +

    Returns: a Python type.

    +

    Classes

    +

    CWLRendererConfiguration

    +
    class CWLRendererConfiguration(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Configuration for the renderer.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    allow_complex_typesNonecan input/output types be other than raw?None
    factories_as_paramsNoneshould factories be treated as input or steps?None
    +

    Ancestors (in MRO)

    +
      +
    • builtins.dict
      • +
    +

    Methods

    +

    clear

    +
    def clear(
+    ...
+)
+
    +

    D.clear() -> None. Remove all items from D.

    +

    copy

    +
    def copy(
+    ...
+)
+
    +

    D.copy() -> a shallow copy of D

    +

    fromkeys

    +
    def fromkeys(
+    iterable,
+    value=None,
+    /
+)
+
    +

    Create a new dictionary with keys from iterable and values set to value.

    +

    get

    +
    def get(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Return the value for key if key is in the dictionary, else default.

    +

    items

    +
    def items(
+    ...
+)
+
    +

    D.items() -> a set-like object providing a view on D's items

    +

    keys

    +
    def keys(
+    ...
+)
+
    +

    D.keys() -> a set-like object providing a view on D's keys

    +

    pop

    +
    def pop(
+    ...
+)
+
    +

    D.pop(k[,d]) -> v, remove specified key and return the corresponding value.

    +

    If the key is not found, return the default if given; otherwise, +raise a KeyError.

    +

    popitem

    +
    def popitem(
+    self,
+    /
+)
+
    +

    Remove and return a (key, value) pair as a 2-tuple.

    +

    Pairs are returned in LIFO (last-in, first-out) order. +Raises KeyError if the dict is empty.

    +

    setdefault

    +
    def setdefault(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Insert key with a value of default if key is not in the dictionary.

    +

    Return the value for key if key is in the dictionary, else default.

    +

    update

    +
    def update(
+    ...
+)
+
    +

    D.update([E, ]**F) -> None. Update D from dict/iterable E and F.

    +

    If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k]

    +

    values

    +
    def values(
+    ...
+)
+
    +

    D.values() -> an object providing a view on D's values

    +

    CommandInputSchema

    +
    class CommandInputSchema(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Structure for referring to a raw type in CWL.

    +

    Encompasses several CWL types. In future, it may be best to +use cwltool or another library for these basic structures.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    typeNoneCWL type of this input.None
    labelNonename to show for this input.None
    fieldsNone(for record) individual fields in a dict-like structure.None
    itemsNone(for array) type that each field will have.None
    +

    Ancestors (in MRO)

    +
      +
    • builtins.dict
      • +
    +

    Methods

    +

    clear

    +
    def clear(
+    ...
+)
+
    +

    D.clear() -> None. Remove all items from D.

    +

    copy

    +
    def copy(
+    ...
+)
+
    +

    D.copy() -> a shallow copy of D

    +

    fromkeys

    +
    def fromkeys(
+    iterable,
+    value=None,
+    /
+)
+
    +

    Create a new dictionary with keys from iterable and values set to value.

    +

    get

    +
    def get(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Return the value for key if key is in the dictionary, else default.

    +

    items

    +
    def items(
+    ...
+)
+
    +

    D.items() -> a set-like object providing a view on D's items

    +

    keys

    +
    def keys(
+    ...
+)
+
    +

    D.keys() -> a set-like object providing a view on D's keys

    +

    pop

    +
    def pop(
+    ...
+)
+
    +

    D.pop(k[,d]) -> v, remove specified key and return the corresponding value.

    +

    If the key is not found, return the default if given; otherwise, +raise a KeyError.

    +

    popitem

    +
    def popitem(
+    self,
+    /
+)
+
    +

    Remove and return a (key, value) pair as a 2-tuple.

    +

    Pairs are returned in LIFO (last-in, first-out) order. +Raises KeyError if the dict is empty.

    +

    setdefault

    +
    def setdefault(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Insert key with a value of default if key is not in the dictionary.

    +

    Return the value for key if key is in the dictionary, else default.

    +

    update

    +
    def update(
+    ...
+)
+
    +

    D.update([E, ]**F) -> None. Update D from dict/iterable E and F.

    +

    If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k]

    +

    values

    +
    def values(
+    ...
+)
+
    +

    D.values() -> an object providing a view on D's values

    +

    CommandOutputSchema

    +
    class CommandOutputSchema(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Structure for referring to an output in CWL.

    +

    As a simplification, this is an input schema with an extra +outputSource field.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    outputSourceNonestep result to use for this output.None
    +

    Ancestors (in MRO)

    +
      +
    • builtins.dict
      • +
    +

    Methods

    +

    clear

    +
    def clear(
+    ...
+)
+
    +

    D.clear() -> None. Remove all items from D.

    +

    copy

    +
    def copy(
+    ...
+)
+
    +

    D.copy() -> a shallow copy of D

    +

    fromkeys

    +
    def fromkeys(
+    iterable,
+    value=None,
+    /
+)
+
    +

    Create a new dictionary with keys from iterable and values set to value.

    +

    get

    +
    def get(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Return the value for key if key is in the dictionary, else default.

    +

    items

    +
    def items(
+    ...
+)
+
    +

    D.items() -> a set-like object providing a view on D's items

    +

    keys

    +
    def keys(
+    ...
+)
+
    +

    D.keys() -> a set-like object providing a view on D's keys

    +

    pop

    +
    def pop(
+    ...
+)
+
    +

    D.pop(k[,d]) -> v, remove specified key and return the corresponding value.

    +

    If the key is not found, return the default if given; otherwise, +raise a KeyError.

    +

    popitem

    +
    def popitem(
+    self,
+    /
+)
+
    +

    Remove and return a (key, value) pair as a 2-tuple.

    +

    Pairs are returned in LIFO (last-in, first-out) order. +Raises KeyError if the dict is empty.

    +

    setdefault

    +
    def setdefault(
+    self,
+    key,
+    default=None,
+    /
+)
+
    +

    Insert key with a value of default if key is not in the dictionary.

    +

    Return the value for key if key is in the dictionary, else default.

    +

    update

    +
    def update(
+    ...
+)
+
    +

    D.update([E, ]**F) -> None. Update D from dict/iterable E and F.

    +

    If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] +If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v +In either case, this is followed by: for k in F: D[k] = F[k]

    +

    values

    +
    def values(
+    ...
+)
+
    +

    D.values() -> an object providing a view on D's values

    +

    InputsDefinition

    +
    class InputsDefinition(
+    inputs: dict[str, 'CommandInputParameter']
+)
+
    +

    CWL-renderable representation of an input parameter block.

    +

    Turns dewret results into a CWL input block.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    inputNonesequence of results from a workflow.None
    +

    Class variables

    +
    CommandInputParameter
+
    +

    Static methods

    +

    from_parameters

    +
    def from_parameters(
+    parameters: list[typing.Union[dewret.workflow.ParameterReference[typing.Any], dewret.workflow.FactoryCall]]
+) -> 'InputsDefinition'
+
    +

    Takes a list of parameters into a CWL structure.

    +

    Uses the parameters to fill out the necessary input fields.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneCWL-like structure representing all workflow outputs.
    +

    Instance variables

    +
    inputs
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Render to a dict-like structure.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    OutputsDefinition

    +
    class OutputsDefinition(
+    outputs: dict[str, 'CommandOutputSchema'] | list['CommandOutputSchema'] | dewret.renderers.cwl.CommandOutputSchema
+)
+
    +

    CWL-renderable set of workflow outputs.

    +

    Turns dewret results into a CWL output block.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    outputsNonesequence of results from a workflow.None
    +

    Static methods

    +

    from_results

    +
    def from_results(
+    results: dict[str, dewret.workflow.StepReference[typing.Any]] | list[dewret.workflow.StepReference[typing.Any]] | tuple[dewret.workflow.StepReference[typing.Any], ...]
+) -> 'OutputsDefinition'
+
    +

    Takes a mapping of results into a CWL structure.

    +

    Pulls the result type from the signature, ultimately, if possible.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneCWL-like structure representing all workflow outputs.
    +

    Instance variables

    +
    outputs
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']] | list[str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Render to a dict-like structure.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    ReferenceDefinition

    +
    class ReferenceDefinition(
+    source: str | None,
+    value_from: str | None
+)
+
    +

    CWL-renderable internal reference.

    +

    Normally points to a value or a step.

    +

    Static methods

    +

    from_reference

    +
    def from_reference(
+    ref: dewret.core.Reference[typing.Any]
+) -> 'ReferenceDefinition'
+
    +

    Build from a Reference.

    +

    Converts a dewret.workflow.Reference into a CWL-rendering object.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    refNonereference to convert.None
    +

    Instance variables

    +
    source
+
    +
    value_from
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Render to a dict-like structure.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    StepDefinition

    +
    class StepDefinition(
+    name: str,
+    run: str,
+    out: dict[str, 'CommandInputSchema'] | list[str],
+    in_: collections.abc.Mapping[str, dewret.renderers.cwl.ReferenceDefinition | dewret.core.Raw]
+)
+
    +

    CWL-renderable step.

    +

    Coerces the dewret structure of a step into that +needed for valid CWL.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    nameNoneidentifier to call this step by.None
    runNonetask to execute for this step.None
    in_Noneinputs from values or other steps.None
    +

    Static methods

    +

    from_step

    +
    def from_step(
+    step: dewret.workflow.BaseStep
+) -> 'StepDefinition'
+
    +

    Build from a BaseStep.

    +

    Converts a dewret.workflow.Step into a CWL-rendering object.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepNonestep to convert.None
    +

    Instance variables

    +
    in_
+
    +
    name
+
    +
    out
+
    +
    run
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Render to a dict-like structure.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    +

    WorkflowDefinition

    +
    class WorkflowDefinition(
+    steps: list[dewret.renderers.cwl.StepDefinition],
+    inputs: dewret.renderers.cwl.InputsDefinition,
+    outputs: dewret.renderers.cwl.OutputsDefinition,
+    name: None | str
+)
+
    +

    CWL-renderable workflow.

    +

    Coerces the dewret structure of a workflow into that +needed for valid CWL.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepsNonesequence of steps in the workflow.None
    +

    Static methods

    +

    from_workflow

    +
    def from_workflow(
+    workflow: dewret.workflow.Workflow,
+    name: None | str = None
+) -> 'WorkflowDefinition'
+
    +

    Build from a Workflow.

    +

    Converts a dewret.workflow.Workflow into a CWL-rendering object.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneworkflow to convert.None
    nameNonename of this workflow, if it should have one.None
    +

    Instance variables

    +
    inputs
+
    +
    name
+
    +
    outputs
+
    +
    steps
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']]
+
    +

    Render to a dict-like structure.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReduced form as a native Python dict structure for
    serialization.
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/renderers/index.html b/reference/dewret/renderers/index.html new file mode 100644 index 00000000..2df0ee86 --- /dev/null +++ b/reference/dewret/renderers/index.html @@ -0,0 +1,784 @@ + + + + + + + + + + + + + + + + Index - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    + +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/renderers/snakemake/index.html b/reference/dewret/renderers/snakemake/index.html new file mode 100644 index 00000000..5c3e19f7 --- /dev/null +++ b/reference/dewret/renderers/snakemake/index.html @@ -0,0 +1,2366 @@ + + + + + + + + + + + + + + + + Snakemake - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.renderers.snakemake

    +

    Snakemake Renderer.

    +

    Outputs a Snakemake representation of the +current workflow.

    +

    Variables

    +
    MainTypes
+
    +

    Functions

    +

    get_method_args

    +
    def get_method_args(
+    func: dewret.workflow.Lazy
+) -> inspect.Signature
+
    +

    Retrieve the argument names and types of a lazy-evaluatable function.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    funcNoneA function that adheres to the Lazy protocol.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneAn ItemsView object containing the argument names and their corresponding
    inspect.Parameter objects.
    +

    get_method_rel_path

    +
    def get_method_rel_path(
+    func: dewret.workflow.Lazy
+) -> Any
+
    +

    Get the relative path of the module containing the given function.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    funcLazyThe function for which the relative path is to be determined.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    anyThe relative path of the module containing the function.
    +

    raw_render

    +
    def raw_render(
+    workflow: dewret.workflow.Workflow
+) -> dict[str, str | float | bool | bytes | int | None | list[str] | list['MainTypes'] | dict[str, 'MainTypes']]
+
    +

    Render the workflow as a Snakemake (SMK) string.

    +

    This function converts a Workflow object into a object containing snakemake rules.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowWorkflowThe workflow to be rendered.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    dict[str, MainTypes]A dictionary containing the components of the Workflow
    definition, for use in Snakemake workflows.
    +

    render

    +
    def render(
+    workflow: dewret.workflow.Workflow
+) -> dict[str, typing.Any]
+
    +

    Render the workflow as a Snakemake (SMK) string.

    +

    This function converts a Workflow object into a Snakemake-compatible yaml.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowWorkflowThe workflow to be rendered.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    strA Snakemake-compatible yaml representation of the workflow.
    +

    to_snakemake_type

    +
    def to_snakemake_type(
+    param: dewret.core.Raw
+) -> str
+
    +

    Convert a raw type to a corresponding Snakemake-compatible Python type.

    +

    This function maps raw types to their corresponding Python types as +used in Snakemake. Snakemake primarily uses Python types for its parameters, +and this function ensures that the provided type is appropriately converted.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    paramNoneThe raw type to be converted, which can be of any type.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA string representing the corresponding Python type for Snakemake.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    TypeErrorIf the parameter's type cannot be mapped to a known Python type.
    +

    Classes

    +

    InputDefinition

    +
    class InputDefinition(
+    inputs: list[str],
+    params: list[str]
+)
+
    +

    Represents input and parameter definitions block for a Snakemake-renderable workflow step.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    inputsList[str]A list of input definitions.None
    paramsList[str]A list of parameter definitions.None
    +

    Static methods

    +

    from_step

    +
    def from_step(
+    step: dewret.workflow.BaseStep
+) -> 'InputDefinition'
+
    +

    Constructs an InputDefinition object from a Step.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepStepThe Step object from which input and parameter block definitions are
    extracted.    		None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    InputDefinitionAn InputDefinition object.
    +

    Instance variables

    +
    inputs
+
    +
    params
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, list[str]]
+
    +

    Renders the input and parameter definitions as a dictionary.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    dict[str, list[MainTypes]]A dictionary containing the input and parameter definitions,
    for use in Snakemake Input and Params blocks.
    +

    OutputDefinition

    +
    class OutputDefinition(
+    output_file: str
+)
+
    +

    Represents the output definition block for a Snakemake-renderable workflow step.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    output_filestrThe output file definition.None
    +

    Static methods

    +

    from_step

    +
    def from_step(
+    step: dewret.workflow.BaseStep
+) -> 'OutputDefinition'
+
    +

    Constructs an OutputDefinition object from a Step.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepStepThe Step object from which the output file definition is extracted.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    OutputDefinitionAn OutputDefinition object, for use in Snakemake Output block.
    +

    Instance variables

    +
    output_file
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> list[str]
+
    +

    Renders the output definition as a list.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    list[str]A list containing the output file definition, for use in a Snakemake Output block.
    +

    ReferenceDefinition

    +
    class ReferenceDefinition(
+    source: str
+)
+
    +

    Represents a Snakemake-renderable internal reference.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    sourcestrThe source of the internal reference.None
    +

    Static methods

    +

    from_reference

    +
    def from_reference(
+    ref: dewret.core.Reference[typing.Any]
+) -> 'ReferenceDefinition'
+
    +

    Build from a Reference.

    +

    Converts a dewret.workflow.Reference into a Snakemake-rendering object.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    refNonereference to convert.None
    +

    Instance variables

    +
    source
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> str
+
    +

    Render the internal reference definition as a string.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    strinternal reference.
    +

    RunDefinition

    +
    class RunDefinition(
+    method_name: str,
+    rel_import: str,
+    args: list[str]
+)
+
    +

    Represents a Snakemake-renderable run block for a dewret workflow step.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    method_namestrThe name of the method to be executed in the snakefile run block.None
    rel_importstrThe relative import path of the method.None
    argsList[str]The arguments to be passed to the method.None
    +

    Static methods

    +

    from_task

    +
    def from_task(
+    task: dewret.workflow.Task | dewret.workflow.Workflow
+) -> 'RunDefinition'
+
    +

    Constructs a RunDefinition object from a Task.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskTaskThe Task object from which method information and arguments
    are extracted.    		None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    RunDefinitionA RunDefinition object containing the converted method
    information and arguments.
    +

    Instance variables

    +
    args
+
    +
    method_name
+
    +
    rel_import
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> list[str]
+
    +

    Renders the run block as a list of strings.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    list[str]A list containing the import statement and the method
    call statement, for use in Snakemake run block.
    +

    StepDefinition

    +
    class StepDefinition(
+    name: str,
+    run: list[str],
+    params: list[str],
+    output: list[str],
+    input: list[str]
+)
+
    +

    Represents a Snakemake-renderable step definition in a dewret workflow.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    namestrThe name of the step.None
    runstrThe run block definition for the step.None
    paramsList[str]The parameter definitions for the step.None
    output (list[str]NoneThe output definition for the step.None
    inputList[str]The input definitions for the step.None
    +

    Static methods

    +

    from_step

    +
    def from_step(
+    step: dewret.workflow.BaseStep
+) -> 'StepDefinition'
+
    +

    Constructs a StepDefinition object from a Step.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepStepThe Step object from which step information and components
    are extracted.    		None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    StepDefinitionA StepDefinition object containing the converted step
    information and components.
    +

    Instance variables

    +
    input
+
    +
    name
+
    +
    output
+
    +
    params
+
    +
    run
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list[str] | list['MainTypes'] | dict[str, 'MainTypes']]
+
    +

    Renders the step definition as a dictionary.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    dict[str, MainTypes]A dictionary containing the components of the step
    definition, for use in Snakemake workflows.
    +

    WorkflowDefinition

    +
    class WorkflowDefinition(
+    steps: list[dewret.renderers.snakemake.StepDefinition]
+)
+
    +

    Represents a Snakemake-renderable workflow definition from a dewret workflow.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepsList[StepDefinition]A list of StepDefinition objects representing the steps
    in the workflow.    		None
    +

    Static methods

    +

    from_workflow

    +
    def from_workflow(
+    workflow: dewret.workflow.Workflow
+) -> 'WorkflowDefinition'
+
    +

    Creates a WorkflowDefinition object from a Workflow object.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowWorkflowThe workflow to be rendered.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    strWorkflowDefinition with definited steps.
    +

    Instance variables

    +
    steps
+
    +

    Methods

    +

    render

    +
    def render(
+    self
+) -> dict[str, str | float | bool | bytes | int | None | list[str] | list['MainTypes'] | dict[str, 'MainTypes']]
+
    +

    Render the WorkflowDefinition.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    dict[str, MainTypes]A dictionary containing the components of the Workflow
    definition, for use in Snakemake workflows.
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/tasks/index.html b/reference/dewret/tasks/index.html new file mode 100644 index 00000000..2479691f --- /dev/null +++ b/reference/dewret/tasks/index.html @@ -0,0 +1,1935 @@ + + + + + + + + + + + + + + + + Tasks - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.tasks

    +

    Abstraction layer for task operations.

    +

    Access dask, or other, backends consistently using this module. It provides +decorators and execution calls that manage tasks. Note that the task +decorator should be called with no arguments, and will return the appropriate +decorator for the current backend.

    +

    Typical usage example:

    +
    >>> @task()
+... def increment(num: int) -> int:
+...     return num + 1
+
    +

    Variables

    +
    DEFAULT_BACKEND
+
    +
    Param
+
    +
    RetType
+
    +
    construct
+
    +

    An alias pointing to an instance of the TaskManager class.

    +

    Used for constructing a set of tasks into a dewret workflow instance.

    +

    Functions

    +

    ensure_lazy

    +
    def ensure_lazy(
+    task: Any
+) -> dewret.workflow.Lazy | None
+
    +

    Evaluate a single task for a known workflow.

    +

    As we mask our lazy-evaluable functions to appear as their original +types to the type system (see dewret.tasks.task), we must cast them +back, to allow the type-checker to comb the remainder of the code.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonethe suspected task to check.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneOriginal task, cast to a Lazy, or None.
    +

    evaluate

    +
    def evaluate(
+    task: dewret.workflow.Lazy | list[dewret.workflow.Lazy] | tuple[dewret.workflow.Lazy],
+    __workflow__: dewret.workflow.Workflow,
+    thread_pool: concurrent.futures.thread.ThreadPoolExecutor | None = None,
+    **kwargs: Any
+) -> Any
+
    +

    Evaluate a single task for a known workflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonethe task to evaluate.None
    workflowNoneworkflow within which this exists.None
    thread_poolNoneexisting pool of threads to run this in, or None.None
    **kwargsNoneany arguments to pass to the task.None
    +

    factory

    +
    def factory(
+    fn: collections.abc.Callable[..., ~RetType]
+) -> collections.abc.Callable[..., ~RetType]
+
    +

    Create a factory, that can be treated as complex input to a workflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fnNonea callable to create the entity.None
    +

    in_nested_task

    +
    def in_nested_task(
+    
+) -> Generator[NoneType, NoneType, NoneType]
+
    +

    Informs the builder that we are within a nested task.

    +

    This is only really relevant in the subworkflow context.

    +

    TODO: check impact of ContextVar being thread-sensitive on build.

    +

    is_in_nested_task

    +
    def is_in_nested_task(
+    
+) -> bool
+
    +

    Check if we are within a nested task.

    +

    Used, for example, to see if discovered parameters should be +treated as "local" (i.e. should take a default to the step) or +global (i.e. should be turned into a workflow parameter) if we +are inside or outside a subworkflow, respectively.

    +

    lazy

    +
    def lazy(
+    
+) -> collections.abc.Callable[[collections.abc.Callable[..., typing.Any]], dewret.workflow.Lazy]
+
    +

    Get the lazy decorator for this backend.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReal decorator for this backend.
    +

    set_backend

    +
    def set_backend(
+    backend: dewret.tasks.Backend
+) -> None
+
    +

    Choose a backend.

    +

    Will raise an error if a backend is already chosen.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    backendNonechosen backend to use from here-on in.None
    +

    task

    +
    def task(
+    nested: bool = False,
+    flatten_nested: bool = True,
+    is_factory: bool = False
+) -> collections.abc.Callable[[collections.abc.Callable[~Param, ~RetType]], collections.abc.Callable[~Param, ~RetType]]
+
    +

    Decorator factory abstracting backend's own task decorator.

    +

    For example:

    +
    >>> @task()
+... def increment(num: int) -> int:
+...     return num + 1
+
    +

    If the backend is dask (the default), it is will evaluate this +as a dask.delayed. Note that, with any backend, dewret will +hijack the decorator to record the attempted evalution rather than +actually evaluating the lazy function. Nonetheless, this hijacking +will still be executed with the backend's lazy executor, so +dask.delayed will still be called, for example, in the dask case.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    nestedNonewhether this should be executed to find other tasks.None
    flatten_nestedNone(only relevant to nested tasks) should this nested task
    be considered a distinct subworkflow, or is it just organizational
    for the outer workflow.    		None
    is_factoryNonewhether this task should be marked as a 'factory', rather than
    a normal step.    		None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneDecorator for the current backend to mark lazy-executable tasks.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    TypeErrorif arguments are missing or incorrect, in line with usual
    Python behaviour.
    +

    unwrap

    +
    def unwrap(
+    task: dewret.workflow.Lazy
+) -> collections.abc.Callable[..., typing.Any]
+
    +

    Unwraps a lazy-evaluated function to get the function.

    +

    Ideally, we could use the __wrapped__ property but not all +workflow engines support this, and most importantly, dask has +only done so as of 2024.03.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonetask to be unwrapped.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneOriginal target.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    RuntimeErrorif the task is not a wrapped function.
    +

    workflow

    +
    def workflow(
+    
+) -> collections.abc.Callable[[collections.abc.Callable[~Param, ~RetType]], collections.abc.Callable[~Param, ~RetType]]
+
    +

    Shortcut for marking a task as nested.

    +

    A nested task is one which calls other tasks and does not +do anything else important. It will not actually get called +at runtime, but should map entirely into the graph. As such, +arithmetic operations on results, etc. will cause errors at +render-time. Combining tasks is acceptable, and intended. The +effect of the nested task will be considered equivalent to whatever +reaching whatever step reference is returned at the end.

    +
    >>> @task()
+... def increment(num: int) -> int:
+...     return num + 1
+
+>>> @workflow()
+... def double_increment(num: int) -> int:
+...     return increment(increment(num=num))
+
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneTask that runs at render, not execution, time.
    +

    Classes

    +

    Backend

    +
    class Backend(
+    *args,
+    **kwds
+)
+
    +

    Stringy enum representing available backends.

    +

    Ancestors (in MRO)

    +
      +
    • enum.Enum
      • +
    +

    Class variables

    +
    DASK
+
    +
    name
+
    +
    value
+
    +

    TaskException

    +
    class TaskException(
+    task: dewret.workflow.Task | collections.abc.Callable[..., typing.Any],
+    dec_tb: traceback | None,
+    tb: traceback | None,
+    message: str,
+    *args: Any,
+    **kwargs: Any
+)
+
    +

    Exception tied to a specific task.

    +

    Primarily aimed at parsing issues, but this will ensure that +a message is shown with useful debug information for the +workflow writer.

    +

    Ancestors (in MRO)

    +
      +
    • builtins.Exception
      • +
    • builtins.BaseException
      • +
    +

    Class variables

    +
    args
+
    +

    Methods

    +

    add_note

    +
    def add_note(
+    ...
+)
+
    +

    Exception.add_note(note) --

    +

    add a note to the exception

    +

    with_traceback

    +
    def with_traceback(
+    ...
+)
+
    +

    Exception.with_traceback(tb) --

    +

    set self.traceback to tb and return self.

    +

    TaskManager

    +
    class TaskManager(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Overarching backend-agnostic task manager.

    +

    Gatekeeps the specific backend implementation. This can be +instantiated without choosing a backend, but the first call to +any of its methods will concretize that choice - either as +the default, or the backend set via TaskManager.set_backend. +It cannot be changed after this point.

    +

    Methods

    +

    backend

    +
    def backend(
+    ...
+)
+
    +

    Import backend module.

    +

    Cached property to load the backend module, if it has not been already.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneBackend module for the specific choice of backend.
    +

    ensure_lazy

    +
    def ensure_lazy(
+    self,
+    task: Any
+) -> dewret.workflow.Lazy | None
+
    +

    Evaluate a single task for a known workflow.

    +

    As we mask our lazy-evaluable functions to appear as their original +types to the type system (see dewret.tasks.task), we must cast them +back, to allow the type-checker to comb the remainder of the code.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonethe suspected task to check.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneOriginal task, cast to a Lazy, or None.
    +

    evaluate

    +
    def evaluate(
+    self,
+    task: dewret.workflow.Lazy | list[dewret.workflow.Lazy] | tuple[dewret.workflow.Lazy],
+    __workflow__: dewret.workflow.Workflow,
+    thread_pool: concurrent.futures.thread.ThreadPoolExecutor | None = None,
+    **kwargs: Any
+) -> Any
+
    +

    Evaluate a single task for a known workflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonethe task to evaluate.None
    workflowNoneworkflow within which this exists.None
    thread_poolNoneexisting pool of threads to run this in, or None.None
    **kwargsNoneany arguments to pass to the task.None
    +

    make_lazy

    +
    def make_lazy(
+    self
+) -> collections.abc.Callable[[collections.abc.Callable[..., typing.Any]], dewret.workflow.Lazy]
+
    +

    Get the lazy decorator for this backend.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneReal decorator for this backend.
    +

    set_backend

    +
    def set_backend(
+    self,
+    backend: dewret.tasks.Backend
+) -> dewret.tasks.Backend
+
    +

    Choose a backend.

    +

    Sets the backend, provided it has not already been loaded.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    backendNonechosen backend, to override the default.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneBackend that was set.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    RuntimeErrorwhen a backend has already been loaded.
    +

    unwrap

    +
    def unwrap(
+    self,
+    task: dewret.workflow.Lazy
+) -> collections.abc.Callable[..., typing.Any]
+
    +

    Unwraps a lazy-evaluated function to get the function.

    +

    Ideally, we could use the __wrapped__ property but not all +workflow engines support this, and most importantly, dask has +only done so as of 2024.03.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonetask to be unwrapped.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneOriginal target.
    +

    Raises:

    + + + + + + + + + + + + + +
    TypeDescription
    RuntimeErrorif the task is not a wrapped function.
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/utils/index.html b/reference/dewret/utils/index.html new file mode 100644 index 00000000..216fb47f --- /dev/null +++ b/reference/dewret/utils/index.html @@ -0,0 +1,1357 @@ + + + + + + + + + + + + + + + + Utils - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.utils

    +

    Utility module.

    +

    General types and functions to centralize common logic.

    +

    Functions

    +

    crawl_raw

    +
    def crawl_raw(
+    value: Any,
+    action: Optional[Callable[[Any], Any]] = None
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+
    +

    Takes a Raw-like structure and makes it RawType.

    +

    Particularly useful for squashing any TypedDicts.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonevalue to squashNone
    actionNonean callback to apply to each found entry, or None.None
    +

    ensure_raw

    +
    def ensure_raw(
+    value: Any,
+    cast_tuple: bool = False
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+
    +

    Check if a variable counts as "raw".

    +

    This works around a checking issue that isinstance of a union of types +assigned to a variable, such as RawType, may throw errors even though Python 3.11+ +does not. Instead, we explicitly make the full union in the statement below.

    +

    firm_to_raw

    +
    def firm_to_raw(
+    value: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | list['FirmType'] | dict[str, 'FirmType'] | tuple['FirmType', ...]
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType']
+
    +

    Convenience wrapper for firm structures.

    +

    Turns structures that would be raw, except for tuples, into raw structures +by mapping any tuples to lists.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonea firm structure (contains raw/tuple values).None
    +

    flatten_if_set

    +
    def flatten_if_set(
+    value: Any
+) -> str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | dewret.utils.Unset
+
    +

    Takes a Raw-like structure and makes it RawType or Unset.

    +

    Flattens if the value is set, but otherwise returns the unset +sentinel value as-is.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonevalue to squashNone
    +

    hasher

    +
    def hasher(
+    construct: str | float | bool | bytes | int | None | list['RawType'] | dict[str, 'RawType'] | list['FirmType'] | dict[str, 'FirmType'] | tuple['FirmType', ...]
+) -> str
+
    +

    Consistently hash a RawType or tuple structure.

    +

    Turns a possibly nested structure of basic types, dicts, lists and tuples +into a consistent hash.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    constructNonestructure to hash.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneHash string that should be unique to the construct. The limits of this uniqueness
    have not yet been explicitly calculated.
    +

    is_expr

    +
    def is_expr(
+    value: Any,
+    permitted_references: type = <class 'dewret.core.Reference'>
+) -> bool
+
    +

    Confirms whether a structure has only raw or expression types.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonea crawlable structure.None
    permitted_referencesNonea class representing the allowed types of References.None
    +

    is_firm

    +
    def is_firm(
+    value: Any,
+    check: Optional[Callable[[Any], bool]] = None
+) -> bool
+
    +

    Confirms whether a function is firm.

    +

    That is, whether its contents are raw or tuples.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    valueNonevalue to check.None
    checkNoneany additional check to apply.None
    +

    is_raw

    +
    def is_raw(
+    value: Any,
+    check: Optional[Callable[[Any], bool]] = None
+) -> bool
+
    +

    Check if a variable counts as "raw".

    +

    This works around a checking issue that isinstance of a union of types +assigned to a variable, such as RawType, may throw errors even though Python 3.11+ +does not. Instead, we explicitly make the full union in the statement below.

    +

    is_raw_type

    +
    def is_raw_type(
+    typ: type
+) -> bool
+
    +

    Check if a type counts as "raw".

    +

    load_module_or_package

    +
    def load_module_or_package(
+    target_name: str,
+    path: pathlib.Path
+) -> module
+
    +

    Convenience loader for modules.

    +

    If an __init__.py is found in the same location as the target, it will try to load the renderer module +as if it is contained in a package and, if it cannot, will fall back to loading the single file.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    target_nameNonemodule name that should appear in sys.modules.None
    pathNonelocation of the module.None
    +

    make_traceback

    +
    def make_traceback(
+    skip: int = 2
+) -> traceback | None
+
    +

    Creates a traceback for the current frame.

    +

    Necessary to allow tracebacks to be prepped for +potential errors in lazy-evaluated functions.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    skipNonenumber of frames to skip before starting traceback.None
    +

    Classes

    +

    DataclassProtocol

    +
    class DataclassProtocol(
+    *args,
+    **kwargs
+)
+
    +

    Format of a dataclass.

    +

    Since dataclasses do not expose a proper type, we use this to +represent them.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Unset

    +
    class Unset(
+    /,
+    *args,
+    **kwargs
+)
+
    +

    Unset variable, with no default value.

    +

    Descendants

    +
      +
    • dewret.workflow.UnsetType
      • +
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/reference/dewret/workflow/index.html b/reference/dewret/workflow/index.html new file mode 100644 index 00000000..84377375 --- /dev/null +++ b/reference/dewret/workflow/index.html @@ -0,0 +1,19741 @@ + + + + + + + + + + + + + + + + Workflow - dewret + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + + + + +
    + + +
    + +
    + + + + + + +
    +
    + + + +
    +
    +
    + + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    +
    + + + +
    +
    + + + + + + + + + +

    Module dewret.workflow

    +

    Overarching workflow concepts.

    +

    Basic constructs for describing a workflow.

    +

    Variables

    +
    AVAILABLE_TYPES
+
    +
    CHECK_IDS
+
    +
    LazyFactory
+
    +
    RetType
+
    +
    StepExecution
+
    +
    T
+
    +
    TYPE_CHECKING
+
    +
    Target
+
    +
    U
+
    +
    UNSET
+
    +
    logger
+
    +

    Functions

    +

    expr_to_references

    +
    def expr_to_references(
+    expression: 'Any',
+    remap: 'Callable[[Any], Any] | None' = None
+) -> 'tuple[ExprType, list[Reference[Any] | Parameter[Any]]]'
+
    +

    Pull out any references, or other free symbols, from an expression.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    expressionNonenormally a reference that can be immediately returned, but may be a sympy expression or a dict/tuple/list/etc. of such.None
    remapNonea callable to project certain values down before extracting symbols, or None.None
    +

    is_task

    +
    def is_task(
+    task: 'Lazy'
+) -> 'bool'
+
    +

    Decide whether this is a task.

    +

    Checks whether the wrapped function has the magic +attribute __step_expression__ set to True, which is +done within task creation.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonelazy-evaluated value, suspected to be a task.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneTrue if task is indeed a task.
    +

    param

    +
    def param(
+    name: 'str',
+    default: 'T | UnsetType[T] | Unset' = <dewret.utils.Unset object at 0x7fd689964a10>,
+    tethered: 'Literal[False] | None | Step | Workflow' = False,
+    typ: 'type[T] | Unset' = <dewret.utils.Unset object at 0x7fd689964a10>,
+    autoname: 'bool' = False
+) -> 'T'
+
    +

    Create a parameter.

    +

    Will cast so it looks like the original type.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneParameter class cast to the type of the supplied default.
    +

    unify_workflows

    +
    def unify_workflows(
+    expression: 'Any',
+    base_workflow: 'Workflow | None',
+    set_only: 'bool' = False
+) -> 'tuple[Basic | None, Workflow | None]'
+
    +

    Takes an expression and ensures all of its references exist in the same workflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    expressionNoneany valid argument to dewret.workflow.expr_to_references.None
    base_workflowNonethe desired workflow to align on, or None.None
    set_onlyNonewhether to bother assimilating all the workflows (False), or to assume that has been done (False).None
    +

    Classes

    +

    BaseStep

    +
    class BaseStep(
+    workflow: 'Workflow',
+    task: 'Task | Workflow',
+    arguments: 'Mapping[str, Reference[Any] | Raw]',
+    raw_as_parameter: 'bool' = False
+)
+
    +

    Lazy-evaluated function call.

    +

    Individual function call to a lazy-evaluatable function, tracked +for building up the Workflow.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    taskNonethe Task being called in this step.None
    argumentsNonekey-value pairs of arguments to this step.None
    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.NestedStep
      • +
    • dewret.workflow.Step
      • +
    +

    Class variables

    +
    positional_args
+
    +

    Instance variables

    +
    id
+
    +

    Consistent ID based on the value.

    +
    name
+
    +

    Name for this step.

    +

    May be remapped by the workflow to something nicer +than the ID.

    +
    return_type
+
    +

    Take the type of the wrapped function from the target.

    +

    Unwraps and inspects the signature, meaning that the original +wrapped function must have a typehint for the return value.

    +

    Methods

    +

    make_reference

    +
    def make_reference(
+    self,
+    **kwargs: 'Any'
+) -> "'StepReference[T]'"
+
    +

    Create a reference to this step.

    +

    Builds a reference to the (result of) this step, which will be iterable if appropriate.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    **kwargsNonearguments for reference constructor, which will be supplemented appropriately.None
    +

    set_workflow

    +
    def set_workflow(
+    self,
+    workflow: 'Workflow',
+    with_arguments: 'bool' = True
+) -> 'None'
+
    +

    Move the step reference to another workflow.

    +

    This method is primarily intended to be called by a step, allowing it to +switch to a new workflow. It also updates the workflow reference for any +arguments that are steps themselves, if specified.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneThe new target workflow to which the step should be moved.None
    with_argumentsNoneIf True, also update the workflow reference for the step's arguments.None
    +

    FactoryCall

    +
    class FactoryCall(
+    workflow: 'Workflow',
+    task: 'Task | Workflow',
+    arguments: 'Mapping[str, Reference[Any] | Raw]',
+    raw_as_parameter: 'bool' = False
+)
+
    +

    Call to a factory function.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.Step
      • +
    • dewret.workflow.BaseStep
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Class variables

    +
    positional_args
+
    +

    Instance variables

    +
    id
+
    +

    Consistent ID based on the value.

    +
    name
+
    +

    Name for this step.

    +

    May be remapped by the workflow to something nicer +than the ID.

    +
    return_type
+
    +

    Take the type of the wrapped function from the target.

    +

    Unwraps and inspects the signature, meaning that the original +wrapped function must have a typehint for the return value.

    +

    Methods

    +

    make_reference

    +
    def make_reference(
+    self,
+    **kwargs: 'Any'
+) -> "'StepReference[T]'"
+
    +

    Create a reference to this step.

    +

    Builds a reference to the (result of) this step, which will be iterable if appropriate.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    **kwargsNonearguments for reference constructor, which will be supplemented appropriately.None
    +

    set_workflow

    +
    def set_workflow(
+    self,
+    workflow: 'Workflow',
+    with_arguments: 'bool' = True
+) -> 'None'
+
    +

    Move the step reference to another workflow.

    +

    This method is primarily intended to be called by a step, allowing it to +switch to a new workflow. It also updates the workflow reference for any +arguments that are steps themselves, if specified.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneThe new target workflow to which the step should be moved.None
    with_argumentsNoneIf True, also update the workflow reference for the step's arguments.None
    +

    FieldableMixin

    +
    class FieldableMixin(
+    self: 'FieldableProtocol',
+    *args: 'Any',
+    field: 'str | int | tuple[str | int, ...] | None' = None,
+    **kwargs: 'Any'
+)
+
    +

    Tooling for enhancing a type with referenceable fields.

    +

    Descendants

    +
      +
    • dewret.workflow.ParameterReference
      • +
    • dewret.workflow.StepReference
      • +
    +

    Methods

    +

    find_field

    +
    def find_field(
+    self: 'FieldableProtocol',
+    field: 'str | int',
+    fallback_type: 'type | None' = None,
+    **init_kwargs: 'Any'
+) -> 'Reference[Any]'
+
    +

    Field within the reference, if possible.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonethe field to search for.None
    fallback_typeNonethe type to use if we do not know a more specific one.None
    **init_kwargsNonearguments to use for constructing a new reference (via __make_reference__).None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA field-specific version of this reference.
    +

    FieldableProtocol

    +
    class FieldableProtocol(
+    *args: 'Any',
+    field: 'str | None' = None,
+    **kwargs: 'Any'
+)
+
    +

    Expected interfaces for a type that can take fields.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonetuple representing the named fields, either strings or integers.None
    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Instance variables

    +
    name
+
    +

    The name for the target, accounting for the field.

    +

    IterableParameterReference

    +
    class IterableParameterReference(
+    typ: type[~U] | None = None,
+    **kwargs: Any
+)
+
    +

    Iterable form of parameter references.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.IterableMixin
      • +
    • dewret.workflow.ParameterReference
      • +
    • dewret.workflow.FieldableMixin
      • +
    • dewret.core.Reference
      • +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Class variables

    +
    ParameterReferenceMetadata
+
    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    find_field

    +
    def find_field(
+    self: 'FieldableProtocol',
+    field: 'str | int',
+    fallback_type: 'type | None' = None,
+    **init_kwargs: 'Any'
+) -> 'Reference[Any]'
+
    +

    Field within the reference, if possible.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonethe field to search for.None
    fallback_typeNonethe type to use if we do not know a more specific one.None
    **init_kwargsNonearguments to use for constructing a new reference (via __make_reference__).None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA field-specific version of this reference.
    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    IterableStepReference

    +
    class IterableStepReference(
+    typ: type[~U] | None = None,
+    **kwargs: Any
+)
+
    +

    Iterable form of a step reference.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.core.IterableMixin
      • +
    • dewret.workflow.StepReference
      • +
    • dewret.workflow.FieldableMixin
      • +
    • dewret.core.Reference
      • +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Class variables

    +
    StepReferenceMetadata
+
    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    find_field

    +
    def find_field(
+    self: 'FieldableProtocol',
+    field: 'str | int',
+    fallback_type: 'type | None' = None,
+    **init_kwargs: 'Any'
+) -> 'Reference[Any]'
+
    +

    Field within the reference, if possible.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonethe field to search for.None
    fallback_typeNonethe type to use if we do not know a more specific one.None
    **init_kwargsNonearguments to use for constructing a new reference (via __make_reference__).None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA field-specific version of this reference.
    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    Lazy

    +
    class Lazy(
+    *args,
+    **kwargs
+)
+
    +

    Requirements for a lazy-evaluatable function.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.LazyEvaluation
      • +
    +

    LazyEvaluation

    +
    class LazyEvaluation(
+    fn: 'Callable[..., RetType]'
+)
+
    +

    Tracks a single evaluation of a lazy function.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.Lazy
      • +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    +

    NestedStep

    +
    class NestedStep(
+    workflow: 'Workflow',
+    name: 'str',
+    subworkflow: 'Workflow',
+    arguments: 'Mapping[str, Basic | Reference[Any] | Raw]',
+    raw_as_parameter: 'bool' = False
+)
+
    +

    Calling out to a subworkflow.

    +

    Type of BaseStep to call a subworkflow, which holds a reference to it.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.BaseStep
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Class variables

    +
    positional_args
+
    +

    Instance variables

    +
    id
+
    +

    Consistent ID based on the value.

    +
    name
+
    +

    Name for this step.

    +

    May be remapped by the workflow to something nicer +than the ID.

    +
    return_type
+
    +

    Take the type of the wrapped function from the target.

    +

    Unwraps and inspects the signature, meaning that the original +wrapped function must have a typehint for the return value.

    +
    subworkflow
+
    +

    Subworkflow that is wrapped.

    +

    Methods

    +

    make_reference

    +
    def make_reference(
+    self,
+    **kwargs: 'Any'
+) -> "'StepReference[T]'"
+
    +

    Create a reference to this step.

    +

    Builds a reference to the (result of) this step, which will be iterable if appropriate.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    **kwargsNonearguments for reference constructor, which will be supplemented appropriately.None
    +

    set_workflow

    +
    def set_workflow(
+    self,
+    workflow: 'Workflow',
+    with_arguments: 'bool' = True
+) -> 'None'
+
    +

    Move the step reference to another workflow.

    +

    This method is primarily intended to be called by a step, allowing it to +switch to a new workflow. It also updates the workflow reference for any +arguments that are steps themselves, if specified.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneThe new target workflow to which the step should be moved.None
    with_argumentsNoneIf True, also update the workflow reference for the step's arguments.None
    +

    Parameter

    +
    class Parameter(
+    name: 'str',
+    default: 'T | UnsetType[T]',
+    tethered: 'Literal[False] | None | Step | Workflow' = None,
+    autoname: 'bool' = False,
+    typ: 'type[T] | Unset' = <dewret.utils.Unset object at 0x7fd689964a10>
+)
+
    +

    Global parameter.

    +

    Independent parameter that will be used when a task is spotted +reaching outside its scope. This wraps the variable it uses.

    +

    To allow for potential arithmetic operations, etc. it is a Sympy +symbol.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    nameNonename of the parameter.None
    defaultNonecaptured default value from the original value.None
    +

    Ancestors (in MRO)

    +
      +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    +

    Class variables

    +
    autoname
+
    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    is_loopable

    +
    def is_loopable(
+    typ: 'type'
+) -> 'bool'
+
    +

    Checks if this type can be looped over.

    +

    In particular, checks if this is an iterable that is NOT a str or bytes, possibly disguised +behind an Annotated.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    typNonetype to check.None
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    default
+
    +

    Retrieve default value for this parameter, or an unset token.

    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Extended name, suitable for rendering.

    +

    This attempts to create a unique name by tying the parameter to a step +if the user has not explicitly provided a name, ideally the one where +we discovered it.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    make_reference

    +
    def make_reference(
+    self,
+    **kwargs: 'Any'
+) -> "'ParameterReference[T]'"
+
    +

    Creates a new reference for the parameter.

    +

    The kwargs will be passed to the constructor, but the

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    typNonetype of the new reference's target.None
    **kwargsNonearguments to pass to the constructor.None
    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    register_caller

    +
    def register_caller(
+    self,
+    caller: 'BaseStep'
+) -> 'None'
+
    +

    Capture a step that uses this parameter.

    +

    Gathers together the steps using this parameter. The first found will +be recorded as the tethered step, and used for forming the name.

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    ParameterReference

    +
    class ParameterReference(
+    parameter: 'Parameter[U]',
+    *args: 'Any',
+    typ: 'type[U] | None' = None,
+    **kwargs: 'Any'
+)
+
    +

    Reference to an individual Parameter.

    +

    Allows us to refer to the outputs of a Parameter in subsequent Parameter +arguments.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    parameterNoneParameter referred to.None
    workflowNoneRelated workflow. In this case, as Parameters are generic
    but ParameterReferences are specific, this carries the actual workflow reference.    		None
    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.FieldableMixin
      • +
    • dewret.core.Reference
      • +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.IterableParameterReference
      • +
    +

    Class variables

    +
    ParameterReferenceMetadata
+
    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    find_field

    +
    def find_field(
+    self: 'FieldableProtocol',
+    field: 'str | int',
+    fallback_type: 'type | None' = None,
+    **init_kwargs: 'Any'
+) -> 'Reference[Any]'
+
    +

    Field within the reference, if possible.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonethe field to search for.None
    fallback_typeNonethe type to use if we do not know a more specific one.None
    **init_kwargsNonearguments to use for constructing a new reference (via __make_reference__).None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA field-specific version of this reference.
    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    Step

    +
    class Step(
+    workflow: 'Workflow',
+    task: 'Task | Workflow',
+    arguments: 'Mapping[str, Reference[Any] | Raw]',
+    raw_as_parameter: 'bool' = False
+)
+
    +

    Regular step.

    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.BaseStep
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.FactoryCall
      • +
    +

    Class variables

    +
    positional_args
+
    +

    Instance variables

    +
    id
+
    +

    Consistent ID based on the value.

    +
    name
+
    +

    Name for this step.

    +

    May be remapped by the workflow to something nicer +than the ID.

    +
    return_type
+
    +

    Take the type of the wrapped function from the target.

    +

    Unwraps and inspects the signature, meaning that the original +wrapped function must have a typehint for the return value.

    +

    Methods

    +

    make_reference

    +
    def make_reference(
+    self,
+    **kwargs: 'Any'
+) -> "'StepReference[T]'"
+
    +

    Create a reference to this step.

    +

    Builds a reference to the (result of) this step, which will be iterable if appropriate.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    **kwargsNonearguments for reference constructor, which will be supplemented appropriately.None
    +

    set_workflow

    +
    def set_workflow(
+    self,
+    workflow: 'Workflow',
+    with_arguments: 'bool' = True
+) -> 'None'
+
    +

    Move the step reference to another workflow.

    +

    This method is primarily intended to be called by a step, allowing it to +switch to a new workflow. It also updates the workflow reference for any +arguments that are steps themselves, if specified.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflowNoneThe new target workflow to which the step should be moved.None
    with_argumentsNoneIf True, also update the workflow reference for the step's arguments.None
    +

    StepReference

    +
    class StepReference(
+    step: 'BaseStep',
+    *args: 'Any',
+    typ: 'type[U] | None' = None,
+    **kwargs: 'Any'
+)
+
    +

    Reference to an individual Step.

    +

    Allows us to refer to the outputs of a Step in subsequent Step +arguments.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    _Nonemetadata wrapping the Step referred to.None
    +

    Ancestors (in MRO)

    +
      +
    • dewret.workflow.FieldableMixin
      • +
    • dewret.core.Reference
      • +
    • typing.Generic
      • +
    • sympy.core.symbol.Symbol
      • +
    • sympy.core.expr.AtomicExpr
      • +
    • sympy.core.basic.Atom
      • +
    • sympy.core.expr.Expr
      • +
    • sympy.logic.boolalg.Boolean
      • +
    • sympy.core.basic.Basic
      • +
    • sympy.printing.defaults.Printable
      • +
    • sympy.core.evalf.EvalfMixin
      • +
    • dewret.core.WorkflowComponent
      • +
    +

    Descendants

    +
      +
    • dewret.workflow.IterableStepReference
      • +
    +

    Class variables

    +
    StepReferenceMetadata
+
    +
    default_assumptions
+
    +
    is_Add
+
    +
    is_AlgebraicNumber
+
    +
    is_Atom
+
    +
    is_Boolean
+
    +
    is_Derivative
+
    +
    is_Dummy
+
    +
    is_Equality
+
    +
    is_Float
+
    +
    is_Function
+
    +
    is_Indexed
+
    +
    is_Integer
+
    +
    is_MatAdd
+
    +
    is_MatMul
+
    +
    is_Matrix
+
    +
    is_Mul
+
    +
    is_Not
+
    +
    is_Number
+
    +
    is_NumberSymbol
+
    +
    is_Order
+
    +
    is_Piecewise
+
    +
    is_Point
+
    +
    is_Poly
+
    +
    is_Pow
+
    +
    is_Rational
+
    +
    is_Relational
+
    +
    is_Symbol
+
    +
    is_Vector
+
    +
    is_Wild
+
    +
    is_comparable
+
    +
    is_number
+
    +
    is_scalar
+
    +
    is_symbol
+
    +

    Static methods

    +

    class_key

    +
    def class_key(
+    
+)
+
    +

    Nice order of classes.

    +

    fromiter

    +
    def fromiter(
+    args,
+    **assumptions
+)
+
    +

    Create a new object from an iterable.

    +

    This is a convenience function that allows one to create objects from +any iterable, without having to convert to a list or tuple first.

    +

    Examples

    +
    +
    +
    +

    from sympy import Tuple +Tuple.fromiter(i for i in range(5)) +(0, 1, 2, 3, 4)

    +
    +
    +
    +

    Instance variables

    +
    args
+
    +

    Returns a tuple of arguments of 'self'.

    +

    Examples

    +
    +
    +
    +

    from sympy import cot +from sympy.abc import x, y

    +

    cot(x).args +(x,)

    +

    cot(x).args[0] +x

    +

    (x*y).args +(x, y)

    +

    (x*y).args[1] +y

    +
    +
    +
    +

    Notes

    +

    Never use self._args, always use self.args. +Only use _args in new when creating a new function. +Do not override .args() from Basic (so that it is easy to +change the interface in the future if needed).

    +
    assumptions0
+
    +
    binary_symbols
+
    +
    canonical_variables
+
    +

    Return a dictionary mapping any variable defined in

    +

    self.bound_symbols to Symbols that do not clash +with any free symbols in the expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x +Lambda(x, 2*x).canonical_variables +{x: _0}

    +
    +
    +
    +
    expr_free_symbols
+
    +
    free_symbols
+
    +
    func
+
    +

    The top-level function in an expression.

    +

    The following should hold for all objects::

    +
    >> x == x.func(*x.args)
+
    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +a = 2x +a.func + +a.args +(2, x) +a.func(a.args) +2x +a == a.func(a.args) +True

    +
    +
    +
    +
    is_algebraic
+
    +
    is_antihermitian
+
    +
    is_commutative
+
    +
    is_complex
+
    +
    is_composite
+
    +
    is_even
+
    +
    is_extended_negative
+
    +
    is_extended_nonnegative
+
    +
    is_extended_nonpositive
+
    +
    is_extended_nonzero
+
    +
    is_extended_positive
+
    +
    is_extended_real
+
    +
    is_finite
+
    +
    is_hermitian
+
    +
    is_imaginary
+
    +
    is_infinite
+
    +
    is_integer
+
    +
    is_irrational
+
    +
    is_negative
+
    +
    is_noninteger
+
    +
    is_nonnegative
+
    +
    is_nonpositive
+
    +
    is_nonzero
+
    +
    is_odd
+
    +
    is_polar
+
    +
    is_positive
+
    +
    is_prime
+
    +
    is_rational
+
    +
    is_real
+
    +
    is_transcendental
+
    +
    is_zero
+
    +
    kind
+
    +
    name
+
    +

    Printable name of the reference.

    +

    Methods

    +

    adjoint

    +
    def adjoint(
+    self
+)
+
    +

    apart

    +
    def apart(
+    self,
+    x=None,
+    **args
+)
+
    +

    See the apart function in sympy.polys

    +

    args_cnc

    +
    def args_cnc(
+    self,
+    cset=False,
+    warn=True,
+    split_1=True
+)
+
    +

    Return [commutative factors, non-commutative factors] of self.

    +

    Explanation

    +

    self is treated as a Mul and the ordering of the factors is maintained. +If cset is True the commutative factors will be returned in a set. +If there were repeated factors (as may happen with an unevaluated Mul) +then an error will be raised unless it is explicitly suppressed by +setting warn to False.

    +

    Note: -1 is always separated from a Number unless split_1 is False.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, oo +A, B = symbols('A B', commutative=0) +x, y = symbols('x y') +(-2xy).args_cnc() +[[-1, 2, x, y], []] +(-2.5x).args_cnc() +[[-1, 2.5, x], []] +(-2xABy).args_cnc() +[[-1, 2, x, y], [A, B]] +(-2xABy).args_cnc(split_1=False) +[[-2, x, y], [A, B]] +(-2x*y).args_cnc(cset=True) +[{-1, 2, x, y}, []]

    +
    +
    +
    +

    The arg is always treated as a Mul:

    +
    +
    +
    +

    (-2 + x + A).args_cnc() +[[], [x - 2 + A]] +(-oo).args_cnc() # -oo is a singleton +[[-1, oo], []]

    +
    +
    +
    +

    as_base_exp

    +
    def as_base_exp(
+    self
+) -> 'tuple[Expr, Expr]'
+
    +

    as_coeff_Add

    +
    def as_coeff_Add(
+    self,
+    rational=False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a summation.

    +

    as_coeff_Mul

    +
    def as_coeff_Mul(
+    self,
+    rational: 'bool' = False
+) -> "tuple['Number', Expr]"
+
    +

    Efficiently extract the coefficient of a product.

    +

    as_coeff_add

    +
    def as_coeff_add(
+    self,
+    *deps
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as an Add, a.

    +

    c should be a Rational added to any terms of the Add that are +independent of deps.

    +

    args should be a tuple of all other terms of a; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is an Add or not but +you want to treat self as an Add or if you want to process the +individual arguments of the tail of self as an Add.

    +
      +
    • if you know self is an Add and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail.
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_add() +(3, ()) +(3 + x).as_coeff_add() +(3, (x,)) +(3 + x + y).as_coeff_add(x) +(y + 3, (x,)) +(3 + y).as_coeff_add(x) +(y + 3, ())

    +
    +
    +
    +

    as_coeff_exponent

    +
    def as_coeff_exponent(
+    self,
+    x
+) -> 'tuple[Expr, Expr]'
+
    +

    c*x**e -> c,e where x can be any symbolic expression.

    +

    as_coeff_mul

    +
    def as_coeff_mul(
+    self,
+    *deps,
+    **kwargs
+) -> 'tuple[Expr, tuple[Expr, ...]]'
+
    +

    Return the tuple (c, args) where self is written as a Mul, m.

    +

    c should be a Rational multiplied by any factors of the Mul that are +independent of deps.

    +

    args should be a tuple of all other factors of m; args is empty +if self is a Number or if self is independent of deps (when given).

    +

    This should be used when you do not know if self is a Mul or not but +you want to treat self as a Mul or if you want to process the +individual arguments of the tail of self as a Mul.

    +
      +
    • if you know self is a Mul and want only the head, use self.args[0];
      • +
    • if you do not want to process the arguments of the tail but need the + tail then use self.as_two_terms() which gives the head and tail;
      • +
    • if you want to split self into an independent and dependent parts + use self.as_independent(*deps)
      • +
    +
    +
    +
    +

    from sympy import S +from sympy.abc import x, y +(S(3)).as_coeff_mul() +(3, ()) +(3xy).as_coeff_mul() +(3, (x, y)) +(3xy).as_coeff_mul(x) +(3y, (x,)) +(3y).as_coeff_mul(x) +(3*y, ())

    +
    +
    +
    +

    as_coefficient

    +
    def as_coefficient(
+    self,
+    expr
+)
+
    +

    Extracts symbolic coefficient at the given expression. In

    +

    other words, this functions separates 'self' into the product +of 'expr' and 'expr'-free coefficient. If such separation +is not possible it will return None.

    +

    Examples

    +
    +
    +
    +

    from sympy import E, pi, sin, I, Poly +from sympy.abc import x

    +

    E.as_coefficient(E) +1 +(2E).as_coefficient(E) +2 +(2sin(E)*E).as_coefficient(E)

    +
    +
    +
    +

    Two terms have E in them so a sum is returned. (If one were +desiring the coefficient of the term exactly matching E then +the constant from the returned expression could be selected. +Or, for greater precision, a method of Poly can be used to +indicate the desired term from which the coefficient is +desired.)

    +
    +
    +
    +

    (2E + xE).as_coefficient(E) +x + 2 +_.args[0] # just want the exact match +2 +p = Poly(2E + xE); p +Poly(xE + 2E, x, E, domain='ZZ') +p.coeff_monomial(E) +2 +p.nth(0, 1) +2

    +
    +
    +
    +

    Since the following cannot be written as a product containing +E as a factor, None is returned. (If the coefficient 2*x is +desired then the coeff method should be used.)

    +
    +
    +
    +

    (2Ex + x).as_coefficient(E) +(2Ex + x).coeff(E) +2*x

    +

    (E*(x + 1) + x).as_coefficient(E)

    +

    (2piI).as_coefficient(piI) +2 +(2I).as_coefficient(pi*I)

    +
    +
    +
    +

    See Also

    +

    coeff: return sum of terms have a given factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    as_coefficients_dict

    +
    def as_coefficients_dict(
+    self,
+    *syms
+)
+
    +

    Return a dictionary mapping terms to their Rational coefficient.

    +

    Since the dictionary is a defaultdict, inquiries about terms which +were not present will return a coefficient of 0.

    +

    If symbols syms are provided, any multiplicative terms +independent of them will be considered a coefficient and a +regular dictionary of syms-dependent generators as keys and +their corresponding coefficients as values will be returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import a, x, y +(3x + ax + 4).as_coefficients_dict() +{1: 4, x: 3, ax: 1} +_[a] +0 +(3ax).as_coefficients_dict() +{ax: 3} +(3ax).as_coefficients_dict(x) +{x: 3a} +(3ax).as_coefficients_dict(y) +{1: 3a*x}

    +
    +
    +
    +

    as_content_primitive

    +
    def as_content_primitive(
+    self,
+    radical=False,
+    clear=True
+)
+
    +

    This method should recursively remove a Rational from all arguments

    +

    and return that (content) and the new self (primitive). The content +should always be positive and Mul(*foo.as_content_primitive()) == foo. +The primitive need not be in canonical form and should try to preserve +the underlying structure if possible (i.e. expand_mul should not be +applied to self).

    +

    Examples

    +
    +
    +
    +

    from sympy import sqrt +from sympy.abc import x, y, z

    +

    eq = 2 + 2x + 2y(3 + 3y)

    +
    +
    +
    +

    The as_content_primitive function is recursive and retains structure:

    +
    +
    +
    +

    eq.as_content_primitive() +(2, x + 3y(y + 1) + 1)

    +
    +
    +
    +

    Integer powers will have Rationals extracted from the base:

    +
    +
    +
    +

    ((2 + 6x)2).as_content_primitive() +(4, (3x + 1)2) +((2 + 6*x)(2y)).as_content_primitive() +(1, (2(3x + 1))(2y))

    +
    +
    +
    +

    Terms may end up joining once their as_content_primitives are added:

    +
    +
    +
    +

    ((5(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(11, x(y + 1)) +((3(x(1 + y)) + 2x(3 + 3y))).as_content_primitive() +(9, x(y + 1)) +((3(z(1 + y)) + 2.0x(3 + 3y))).as_content_primitive() +(1, 6.0x(y + 1) + 3z(y + 1)) +((5(x(1 + y)) + 2x(3 + 3y))2).as_content_primitive() +(121, x2(y + 1)2) +((x(1 + y) + 0.4x(3 + 3y))2).as_content_primitive() +(1, 4.84x2*(y + 1)2)

    +
    +
    +
    +

    Radical content can also be factored out of the primitive:

    +
    +
    +
    +

    (2sqrt(2) + 4sqrt(10)).as_content_primitive(radical=True) +(2, sqrt(2)(1 + 2sqrt(5)))

    +
    +
    +
    +

    If clear=False (default is True) then content will not be removed +from an Add if it can be distributed to leave one or more +terms with integer coefficients.

    +
    +
    +
    +

    (x/2 + y).as_content_primitive() +(1/2, x + 2*y) +(x/2 + y).as_content_primitive(clear=False) +(1, x/2 + y)

    +
    +
    +
    +

    as_dummy

    +
    def as_dummy(
+    self
+)
+
    +

    Return the expression with any objects having structurally

    +

    bound symbols replaced with unique, canonical symbols within +the object in which they appear and having only the default +assumption for commutativity being True. When applied to a +symbol a new symbol having only the same commutativity will be +returned.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Symbol +from sympy.abc import x +r = Symbol('r', real=True) +Integral(r, (r, x)).as_dummy() +Integral(0, (_0, x)) +.variables[0].is_real is None +True +r.as_dummy() +_r

    +
    +
    +
    +

    Notes

    +

    Any object that has structurally bound variables should have +a property, bound_symbols that returns those symbols +appearing in the object.

    +

    as_expr

    +
    def as_expr(
+    self,
+    *gens
+)
+
    +

    Convert a polynomial to a SymPy expression.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    f = (x2 + x*y).as_poly(x, y) +f.as_expr() +x2 + x*y

    +

    sin(x).as_expr() +sin(x)

    +
    +
    +
    +

    as_independent

    +
    def as_independent(
+    self,
+    *deps,
+    **hint
+) -> 'tuple[Expr, Expr]'
+
    +

    A mostly naive separation of a Mul or Add into arguments that are not

    +

    are dependent on deps. To obtain as complete a separation of variables +as possible, use a separation method first, e.g.:

    +
      +
    • separatevars() to change Mul, Add and Pow (including exp) into Mul
      • +
    • .expand(mul=True) to change Add or Mul into Add
      • +
    • .expand(log=True) to change log expr into an Add
      • +
    +

    The only non-naive thing that is done here is to respect noncommutative +ordering of variables and to always return (0, 0) for self of zero +regardless of hints.

    +

    For nonzero self, the returned tuple (i, d) has the +following interpretation:

    +
      +
    • i will has no variable that appears in deps
      • +
    • d will either have terms that contain variables that are in deps, or + be equal to 0 (when self is an Add) or 1 (when self is a Mul)
      • +
    • if self is an Add then self = i + d
      • +
    • if self is a Mul then self = i*d
      • +
    • otherwise (self, S.One) or (S.One, self) is returned.
      • +
    +

    To force the expression to be treated as an Add, use the hint as_Add=True

    +

    Examples

    +

    -- self is an Add

    +
    +
    +
    +

    from sympy import sin, cos, exp +from sympy.abc import x, y, z

    +

    (x + xy).as_independent(x) +(0, xy + x) +(x + xy).as_independent(y) +(x, xy) +(2xsin(x) + y + x + z).as_independent(x) +(y + z, 2xsin(x) + x) +(2xsin(x) + y + x + z).as_independent(x, y) +(z, 2xsin(x) + x + y)

    +
    +
    +
    +

    -- self is a Mul

    +
    +
    +
    +

    (xsin(x)cos(y)).as_independent(x) +(cos(y), x*sin(x))

    +
    +
    +
    +

    non-commutative terms cannot always be separated out when self is a Mul

    +
    +
    +
    +

    from sympy import symbols +n1, n2, n3 = symbols('n1 n2 n3', commutative=False) +(n1 + n1n2).as_independent(n2) +(n1, n1n2) +(n2n1 + n1n2).as_independent(n2) +(0, n1n2 + n2n1) +(n1n2n3).as_independent(n1) +(1, n1n2n3) +(n1n2n3).as_independent(n2) +(n1, n2n3) +((x-n1)(x-y)).as_independent(x) +(1, (x - y)*(x - n1))

    +
    +
    +
    +

    -- self is anything else:

    +
    +
    +
    +

    (sin(x)).as_independent(x) +(1, sin(x)) +(sin(x)).as_independent(y) +(sin(x), 1) +exp(x+y).as_independent(x) +(1, exp(x + y))

    +
    +
    +
    +

    -- force self to be treated as an Add:

    +
    +
    +
    +

    (3x).as_independent(x, as_Add=True) +(0, 3x)

    +
    +
    +
    +

    -- force self to be treated as a Mul:

    +
    +
    +
    +

    (3+x).as_independent(x, as_Add=False) +(1, x + 3) +(-3+x).as_independent(x, as_Add=False) +(1, x - 3)

    +
    +
    +
    +

    Note how the below differs from the above in making the +constant on the dep term positive.

    +
    +
    +
    +

    (y*(-3+x)).as_independent(x) +(y, x - 3)

    +
    +
    +
    +

    -- use .as_independent() for true independence testing instead + of .has(). The former considers only symbols in the free + symbols while the latter considers all symbols

    +
    +
    +
    +

    from sympy import Integral +I = Integral(x, (x, 1, 2)) +I.has(x) +True +x in I.free_symbols +False +I.as_independent(x) == (I, 1) +True +(I + x).as_independent(x) == (I, x) +True

    +
    +
    +
    +

    Note: when trying to get independent terms, a separation method +might need to be used first. In this case, it is important to keep +track of what you send to this routine so you know how to interpret +the returned values

    +
    +
    +
    +

    from sympy import separatevars, log +separatevars(exp(x+y)).as_independent(x) +(exp(y), exp(x)) +(x + xy).as_independent(y) +(x, xy) +separatevars(x + xy).as_independent(y) +(x, y + 1) +(x(1 + y)).as_independent(y) +(x, y + 1) +(x(1 + y)).expand(mul=True).as_independent(y) +(x, xy) +a, b=symbols('a b', positive=True) +(log(a*b).expand(log=True)).as_independent(b) +(log(a), log(b))

    +
    +
    +
    +

    See Also

    +

    separatevars +expand_log +sympy.core.add.Add.as_two_terms +sympy.core.mul.Mul.as_two_terms +as_coeff_mul

    +

    as_leading_term

    +
    def as_leading_term(
+    self,
+    *symbols,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading (nonzero) term of the series expansion of self.

    +

    The _eval_as_leading_term routines are used to do this, and they must +always return a non-zero value.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1 + x + x2).as_leading_term(x) +1 +(1/x2 + x + x2).as_leading_term(x) +x(-2)

    +
    +
    +
    +

    as_numer_denom

    +
    def as_numer_denom(
+    self
+)
+
    +

    Return the numerator and the denominator of an expression.

    +

    expression -> a/b -> a, b

    +

    This is just a stub that should be defined by +an object's class methods to get anything else.

    +

    See Also

    +

    normal: return a/b instead of (a, b)

    +

    as_ordered_factors

    +
    def as_ordered_factors(
+    self,
+    order=None
+)
+
    +

    Return list of ordered factors (if Mul) else [self].

    +

    as_ordered_terms

    +
    def as_ordered_terms(
+    self,
+    order=None,
+    data=False
+)
+
    +

    Transform an expression to an ordered list of terms.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, cos +from sympy.abc import x

    +

    (sin(x)2*cos(x) + sin(x)2 + 1).as_ordered_terms() +[sin(x)2*cos(x), sin(x)2, 1]

    +
    +
    +
    +

    as_poly

    +
    def as_poly(
+    self,
+    *gens,
+    **args
+)
+
    +

    Converts self to a polynomial or returns None.

    +

    Explanation

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y

    +

    print((x2 + x*y).as_poly()) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x2 + x*y).as_poly(x, y)) +Poly(x2 + x*y, x, y, domain='ZZ')

    +

    print((x**2 + sin(y)).as_poly(x, y)) +None

    +
    +
    +
    +

    as_powers_dict

    +
    def as_powers_dict(
+    self
+)
+
    +

    Return self as a dictionary of factors with each factor being

    +

    treated as a power. The keys are the bases of the factors and the +values, the corresponding exponents. The resulting dictionary should +be used with caution if the expression is a Mul and contains non- +commutative factors since the order that they appeared will be lost in +the dictionary.

    +

    See Also

    +

    as_ordered_factors: An alternative for noncommutative applications, + returning an ordered list of factors. +args_cnc: Similar to as_ordered_factors, but guarantees separation + of commutative and noncommutative factors.

    +

    as_real_imag

    +
    def as_real_imag(
+    self,
+    deep=True,
+    **hints
+)
+
    +

    Performs complex expansion on 'self' and returns a tuple

    +

    containing collected both real and imaginary parts. This +method cannot be confused with re() and im() functions, +which does not perform complex expansion at evaluation.

    +

    However it is possible to expand both re() and im() +functions and get exactly the same results as with +a single call to this function.

    +
    +
    +
    +

    from sympy import symbols, I

    +

    x, y = symbols('x,y', real=True)

    +

    (x + y*I).as_real_imag() +(x, y)

    +

    from sympy.abc import z, w

    +

    (z + w*I).as_real_imag() +(re(z) - im(w), re(w) + im(z))

    +
    +
    +
    +

    as_set

    +
    def as_set(
+    self
+)
+
    +

    Rewrites Boolean expression in terms of real sets.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Eq, Or, And +x = Symbol('x', real=True) +Eq(x, 0).as_set() +{0} +(x > 0).as_set() +Interval.open(0, oo) +And(-2 < x, x < 2).as_set() +Interval.open(-2, 2) +Or(x < -2, 2 < x).as_set() +Union(Interval.open(-oo, -2), Interval.open(2, oo))

    +
    +
    +
    +

    as_terms

    +
    def as_terms(
+    self
+)
+
    +

    Transform an expression to a list of terms.

    +

    aseries

    +
    def aseries(
+    self,
+    x=None,
+    n=6,
+    bound=0,
+    hir=False
+)
+
    +

    Asymptotic Series expansion of self.

    +

    This is equivalent to self.series(x, oo, n).

    +

    Parameters

    +

    self : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    hir : Boolean + Set this parameter to be True to produce hierarchical series. + It stops the recursion at an early level and may provide nicer + and more useful results.

    +

    bound : Value, Integer + Use the bound parameter to give limit on rewriting + coefficients in its normalised form.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, exp +from sympy.abc import x

    +

    e = sin(1/x + exp(-x)) - sin(1/x)

    +

    e.aseries(x) +(1/(24x4) - 1/(2x2) + 1 + O(x(-6), (x, oo)))*exp(-x)

    +

    e.aseries(x, n=3, hir=True) +-exp(-2x)sin(1/x)/2 + exp(-x)cos(1/x) + O(exp(-3x), (x, oo))

    +

    e = exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x) +exp(exp(x)/(1 - 1/x))

    +

    e.aseries(x, bound=3) # doctest: +SKIP +exp(exp(x)/x2)exp(exp(x)/x)exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x2)*exp(exp(x))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).aseries(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr + Asymptotic series expansion of the expression.

    +

    Notes

    +

    This algorithm is directly induced from the limit computational algorithm provided by Gruntz. +It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first +to look for the most rapidly varying subexpression w of a given expression f and then expands f +in a series in w. Then same thing is recursively done on the leading coefficient +till we get constant coefficients.

    +

    If the most rapidly varying subexpression of a given expression f is f itself, +the algorithm tries to find a normalised representation of the mrv set and rewrites f +using this normalised representation.

    +

    If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) +where w belongs to the most rapidly varying expression of self.

    +

    References

    +

    .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. + In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. + pp. 239-244. +.. [2] Gruntz thesis - p90 +.. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion

    +

    See Also

    +

    Expr.aseries: See the docstring of this function for complete details of this wrapper.

    +

    atoms

    +
    def atoms(
+    self,
+    *types
+)
+
    +

    Returns the atoms that form the current object.

    +

    By default, only objects that are truly atomic and cannot +be divided into smaller pieces are returned: symbols, numbers, +and number symbols like I and pi. It is possible to request +atoms of any type, however, as demonstrated below.

    +

    Examples

    +
    +
    +
    +

    from sympy import I, pi, sin +from sympy.abc import x, y +(1 + x + 2sin(y + Ipi)).atoms() +{1, 2, I, pi, x, y}

    +
    +
    +
    +

    If one or more types are given, the results will contain only +those types of atoms.

    +
    +
    +
    +

    from sympy import Number, NumberSymbol, Symbol +(1 + x + 2sin(y + Ipi)).atoms(Symbol) +{x, y}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number) +{1, 2}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol) +{1, 2, pi}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Number, NumberSymbol, I) +{1, 2, I, pi}

    +
    +
    +
    +

    Note that I (imaginary unit) and zoo (complex infinity) are special +types of number symbols and are not part of the NumberSymbol class.

    +

    The type can be given implicitly, too:

    +
    +
    +
    +

    (1 + x + 2sin(y + Ipi)).atoms(x) # x is a Symbol +{x, y}

    +
    +
    +
    +

    Be careful to check your assumptions when using the implicit option +since S(1).is_Integer = True but type(S(1)) is One, a special type +of SymPy atom, while type(S(2)) is type Integer and will find all +integers in an expression:

    +
    +
    +
    +

    from sympy import S +(1 + x + 2sin(y + Ipi)).atoms(S(1)) +{1}

    +

    (1 + x + 2sin(y + Ipi)).atoms(S(2)) +{1, 2}

    +
    +
    +
    +

    Finally, arguments to atoms() can select more than atomic atoms: any +SymPy type (loaded in core/init.py) can be listed as an argument +and those types of "atoms" as found in scanning the arguments of the +expression recursively:

    +
    +
    +
    +

    from sympy import Function, Mul +from sympy.core.function import AppliedUndef +f = Function('f') +(1 + f(x) + 2sin(y + Ipi)).atoms(Function) +{f(x), sin(y + Ipi)} +(1 + f(x) + 2sin(y + I*pi)).atoms(AppliedUndef) +{f(x)}

    +

    (1 + x + 2sin(y + Ipi)).atoms(Mul) +{Ipi, 2sin(y + I*pi)}

    +
    +
    +
    +

    cancel

    +
    def cancel(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the cancel function in sympy.polys

    +

    coeff

    +
    def coeff(
+    self,
+    x,
+    n=1,
+    right=False,
+    _first=True
+)
+
    +

    Returns the coefficient from the term(s) containing x**n. If n

    +

    is zero then all terms independent of x will be returned.

    +

    Explanation

    +

    When x is noncommutative, the coefficient to the left (default) or +right of x can be returned. The keyword 'right' is ignored when +x is commutative.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols +from sympy.abc import x, y, z

    +
    +
    +
    +

    You can select terms that have an explicit negative in front of them:

    +
    +
    +
    +

    (-x + 2y).coeff(-1) +x +(x - 2y).coeff(-1) +2*y

    +
    +
    +
    +

    You can select terms with no Rational coefficient:

    +
    +
    +
    +

    (x + 2y).coeff(1) +x +(3 + 2x + 4x*2).coeff(1) +0

    +
    +
    +
    +

    You can select terms independent of x by making n=0; in this case +expr.as_independent(x)[0] is returned (and 0 will be returned instead +of None):

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x, 0) +3 +eq = ((x + 1)3).expand() + 1 +eq +x3 + 3*x2 + 3*x + 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 2] +eq -= 2 +[eq.coeff(x, i) for i in reversed(range(4))] +[1, 3, 3, 0]

    +
    +
    +
    +

    You can select terms that have a numerical term in front of them:

    +
    +
    +
    +

    (-x - 2y).coeff(2) +-y +from sympy import sqrt +(x + sqrt(2)x).coeff(sqrt(2)) +x

    +
    +
    +
    +

    The matching is exact:

    +
    +
    +
    +

    (3 + 2x + 4x2).coeff(x) +2 +(3 + 2x + 4x2).coeff(x2) +4 +(3 + 2x + 4x2).coeff(x3) +0 +(z*(x + y)2).coeff((x + y)2) +z +(z*(x + y)2).coeff(x + y) +0

    +
    +
    +
    +

    In addition, no factoring is done, so 1 + z*(1 + y) is not obtained +from the following:

    +
    +
    +
    +

    (x + z(x + xy)).coeff(x) +1

    +
    +
    +
    +

    If such factoring is desired, factor_terms can be used first:

    +
    +
    +
    +

    from sympy import factor_terms +factor_terms(x + z(x + xy)).coeff(x) +z*(y + 1) + 1

    +

    n, m, o = symbols('n m o', commutative=False) +n.coeff(n) +1 +(3n).coeff(n) +3 +(nm + mnm).coeff(n) # = (1 + m)nm +1 + m +(nm + mnm).coeff(n, right=True) # = (1 + m)n*m +m

    +
    +
    +
    +

    If there is more than one possible coefficient 0 is returned:

    +
    +
    +
    +

    (nm + mn).coeff(n) +0

    +
    +
    +
    +

    If there is only one possible coefficient, it is returned:

    +
    +
    +
    +

    (nm + xmn).coeff(mn) +x +(nm + xmn).coeff(mn, right=1) +1

    +
    +
    +
    +

    See Also

    +

    as_coefficient: separate the expression into a coefficient and factor +as_coeff_Add: separate the additive constant from an expression +as_coeff_Mul: separate the multiplicative constant from an expression +as_independent: separate x-dependent terms/factors from others +sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly +sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used

    +

    collect

    +
    def collect(
+    self,
+    syms,
+    func=None,
+    evaluate=True,
+    exact=False,
+    distribute_order_term=True
+)
+
    +

    See the collect function in sympy.simplify

    +

    combsimp

    +
    def combsimp(
+    self
+)
+
    +

    See the combsimp function in sympy.simplify

    +

    compare

    +
    def compare(
+    self,
+    other
+)
+
    +

    Return -1, 0, 1 if the object is less than, equal,

    +

    or greater than other in a canonical sense. +Non-Basic are always greater than Basic. +If both names of the classes being compared appear +in the ordering_of_classes then the ordering will +depend on the appearance of the names there. +If either does not appear in that list, then the +comparison is based on the class name. +If the names are the same then a comparison is made +on the length of the hashable content. +Items of the equal-lengthed contents are then +successively compared using the same rules. If there +is never a difference then 0 is returned.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +x.compare(y) +-1 +x.compare(x) +0 +y.compare(x) +1

    +
    +
    +
    +

    compute_leading_term

    +
    def compute_leading_term(
+    self,
+    x,
+    logx=None
+)
+
    +

    Deprecated function to compute the leading term of a series.

    +

    as_leading_term is only allowed for results of .series() +This is a wrapper to compute a series first.

    +

    conjugate

    +
    def conjugate(
+    self
+)
+
    +

    Returns the complex conjugate of 'self'.

    +

    copy

    +
    def copy(
+    self
+)
+
    +

    could_extract_minus_sign

    +
    def could_extract_minus_sign(
+    self
+)
+
    +

    Return True if self has -1 as a leading factor or has

    +

    more literal negative signs than positive signs in a sum, +otherwise False.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = x - y +{i.could_extract_minus_sign() for i in (e, -e)} +{False, True}

    +
    +
    +
    +

    Though the y - x is considered like -(x - y), since it +is in a product without a leading factor of -1, the result is +false below:

    +
    +
    +
    +

    (x*(y - x)).could_extract_minus_sign() +False

    +
    +
    +
    +

    To put something in canonical form wrt to sign, use signsimp:

    +
    +
    +
    +

    from sympy import signsimp +signsimp(x(y - x)) +-x(x - y) +_.could_extract_minus_sign() +True

    +
    +
    +
    +

    count

    +
    def count(
+    self,
+    query
+)
+
    +

    Count the number of matching subexpressions.

    +

    count_ops

    +
    def count_ops(
+    self,
+    visual=None
+)
+
    +

    Wrapper for count_ops that returns the operation count.

    +

    diff

    +
    def diff(
+    self,
+    *symbols,
+    **assumptions
+)
+
    +

    dir

    +
    def dir(
+    self,
+    x,
+    cdir
+)
+
    +

    doit

    +
    def doit(
+    self,
+    **hints
+)
+
    +

    Evaluate objects that are not evaluated by default like limits,

    +

    integrals, sums and products. All objects of this kind will be +evaluated recursively, unless some species were excluded via 'hints' +or unless the 'deep' hint was set to 'False'.

    +
    +
    +
    +

    from sympy import Integral +from sympy.abc import x

    +

    2Integral(x, x) +2Integral(x, x)

    +

    (2Integral(x, x)).doit() +x*2

    +

    (2Integral(x, x)).doit(deep=False) +2Integral(x, x)

    +
    +
    +
    +

    dummy_eq

    +
    def dummy_eq(
+    self,
+    other,
+    symbol=None
+)
+
    +

    Compare two expressions and handle dummy symbols.

    +

    Examples

    +
    +
    +
    +

    from sympy import Dummy +from sympy.abc import x, y

    +

    u = Dummy('u')

    +

    (u2 + 1).dummy_eq(x2 + 1) +True +(u2 + 1) == (x2 + 1) +False

    +

    (u2 + y).dummy_eq(x2 + y, x) +True +(u2 + y).dummy_eq(x2 + y, y) +False

    +
    +
    +
    +

    equals

    +
    def equals(
+    self,
+    other,
+    failing_expression=False
+)
+
    +

    Return True if self == other, False if it does not, or None. If

    +

    failing_expression is True then the expression which did not simplify +to a 0 will be returned instead of None.

    +

    Explanation

    +

    If self is a Number (or complex number) that is not zero, then +the result is False.

    +

    If self is a number and has not evaluated to zero, evalf will be +used to test whether the expression evaluates to zero. If it does so +and the result has significance (i.e. the precision is either -1, for +a Rational result, or is greater than 1) then the evalf value will be +used to return True or False.

    +

    evalf

    +
    def evalf(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    expand

    +
    def expand(
+    self,
+    deep=True,
+    modulus=None,
+    power_base=True,
+    power_exp=True,
+    mul=True,
+    log=True,
+    multinomial=True,
+    basic=True,
+    **hints
+)
+
    +

    Expand an expression using hints.

    +

    See the docstring of the expand() function in sympy.core.function for +more information.

    +

    extract_additively

    +
    def extract_additively(
+    self,
+    c
+)
+
    +

    Return self - c if it's possible to subtract c from self and

    +

    make all matching coefficients move towards zero, else return None.

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x, y +e = 2x + 3 +e.extract_additively(x + 1) +x + 2 +e.extract_additively(3x) +e.extract_additively(4) +(y(x + 1)).extract_additively(x + 1) +((x + 1)(x + 2y + 1) + 3).extract_additively(x + 1) +(x + 1)(x + 2*y) + 3

    +
    +
    +
    +

    See Also

    +

    extract_multiplicatively +coeff +as_coefficient

    +

    extract_branch_factor

    +
    def extract_branch_factor(
+    self,
+    allow_half=False
+)
+
    +

    Try to write self as exp_polar(2*pi*I*n)*z in a nice way.

    +

    Return (z, n).

    +
    +
    +
    +

    from sympy import exp_polar, I, pi +from sympy.abc import x, y +exp_polar(Ipi).extract_branch_factor() +(exp_polar(Ipi), 0) +exp_polar(2Ipi).extract_branch_factor() +(1, 1) +exp_polar(-piI).extract_branch_factor() +(exp_polar(Ipi), -1) +exp_polar(3piI + x).extract_branch_factor() +(exp_polar(x + Ipi), 1) +(yexp_polar(-5piI)exp_polar(3piI + 2pix)).extract_branch_factor() +(yexp_polar(2pix), -1) +exp_polar(-Ipi/2).extract_branch_factor() +(exp_polar(-Ipi/2), 0)

    +
    +
    +
    +

    If allow_half is True, also extract exp_polar(I*pi):

    +
    +
    +
    +

    exp_polar(Ipi).extract_branch_factor(allow_half=True) +(1, 1/2) +exp_polar(2Ipi).extract_branch_factor(allow_half=True) +(1, 1) +exp_polar(3Ipi).extract_branch_factor(allow_half=True) +(1, 3/2) +exp_polar(-Ipi).extract_branch_factor(allow_half=True) +(1, -1/2)

    +
    +
    +
    +

    extract_multiplicatively

    +
    def extract_multiplicatively(
+    self,
+    c
+)
+
    +

    Return None if it's not possible to make self in the form

    +

    c * something in a nice way, i.e. preserving the properties +of arguments of self.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Rational

    +

    x, y = symbols('x,y', real=True)

    +

    ((xy)3).extract_multiplicatively(x2 * y) +xy**2

    +

    ((xy)3).extract_multiplicatively(x*4 * y)

    +

    (2*x).extract_multiplicatively(2) +x

    +

    (2*x).extract_multiplicatively(3)

    +

    (Rational(1, 2)*x).extract_multiplicatively(3) +x/6

    +
    +
    +
    +

    factor

    +
    def factor(
+    self,
+    *gens,
+    **args
+)
+
    +

    See the factor() function in sympy.polys.polytools

    +

    find

    +
    def find(
+    self,
+    query,
+    group=False
+)
+
    +

    Find all subexpressions matching a query.

    +

    find_field

    +
    def find_field(
+    self: 'FieldableProtocol',
+    field: 'str | int',
+    fallback_type: 'type | None' = None,
+    **init_kwargs: 'Any'
+) -> 'Reference[Any]'
+
    +

    Field within the reference, if possible.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fieldNonethe field to search for.None
    fallback_typeNonethe type to use if we do not know a more specific one.None
    **init_kwargsNonearguments to use for constructing a new reference (via __make_reference__).None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA field-specific version of this reference.
    +

    fourier_series

    +
    def fourier_series(
+    self,
+    limits=None
+)
+
    +

    Compute fourier sine/cosine series of self.

    +

    See the docstring of the :func:fourier_series in sympy.series.fourier +for more information.

    +

    fps

    +
    def fps(
+    self,
+    x=None,
+    x0=0,
+    dir=1,
+    hyper=True,
+    order=4,
+    rational=True,
+    full=False
+)
+
    +

    Compute formal power power series of self.

    +

    See the docstring of the :func:fps function in sympy.series.formal for +more information.

    +

    gammasimp

    +
    def gammasimp(
+    self
+)
+
    +

    See the gammasimp function in sympy.simplify

    +

    getO

    +
    def getO(
+    self
+)
+
    +

    Returns the additive O(..) symbol if there is one, else None.

    +

    getn

    +
    def getn(
+    self
+)
+
    +

    Returns the order of the expression.

    +

    Explanation

    +

    The order is determined either from the O(...) term. If there +is no O(...) term, it returns None.

    +

    Examples

    +
    +
    +
    +

    from sympy import O +from sympy.abc import x +(1 + x + O(x**2)).getn() +2 +(1 + x).getn()

    +
    +
    +
    +

    has

    +
    def has(
+    self,
+    *patterns
+)
+
    +

    Test whether any subexpression matches any of the patterns.

    +

    Examples

    +
    +
    +
    +

    from sympy import sin +from sympy.abc import x, y, z +(x2 + sin(x*y)).has(z) +False +(x2 + sin(x*y)).has(x, y, z) +True +x.has(x) +True

    +
    +
    +
    +

    Note has is a structural algorithm with no knowledge of +mathematics. Consider the following half-open interval:

    +
    +
    +
    +

    from sympy import Interval +i = Interval.Lopen(0, 5); i +Interval.Lopen(0, 5) +i.args +(0, 5, True, False) +i.has(4) # there is no "4" in the arguments +False +i.has(0) # there is a "0" in the arguments +True

    +
    +
    +
    +

    Instead, use contains to determine whether a number is in the +interval or not:

    +
    +
    +
    +

    i.contains(4) +True +i.contains(0) +False

    +
    +
    +
    +

    Note that expr.has(*patterns) is exactly equivalent to +any(expr.has(p) for p in patterns). In particular, False is +returned when the list of patterns is empty.

    +
    +
    +
    +

    x.has() +False

    +
    +
    +
    +

    has_free

    +
    def has_free(
+    self,
+    *patterns
+)
+
    +

    Return True if self has object(s) x as a free expression

    +

    else False.

    +

    Examples

    +
    +
    +
    +

    from sympy import Integral, Function +from sympy.abc import x, y +f = Function('f') +g = Function('g') +expr = Integral(f(x), (f(x), 1, g(y))) +expr.free_symbols +{y} +expr.has_free(g(y)) +True +expr.has_free(*(x, f(x))) +False

    +
    +
    +
    +

    This works for subexpressions and types, too:

    +
    +
    +
    +

    expr.has_free(g) +True +(x + y + 1).has_free(y + 1) +True

    +
    +
    +
    +

    has_xfree

    +
    def has_xfree(
+    self,
+    s: 'set[Basic]'
+)
+
    +

    Return True if self has any of the patterns in s as a

    +

    free argument, else False. This is like Basic.has_free +but this will only report exact argument matches.

    +

    Examples

    +
    +
    +
    +

    from sympy import Function +from sympy.abc import x, y +f = Function('f') +f(x).has_xfree({f}) +False +f(x).has_xfree({f(x)}) +True +f(x + 1).has_xfree({x}) +True +f(x + 1).has_xfree({x + 1}) +True +f(x + y + 1).has_xfree({x + 1}) +False

    +
    +
    +
    +

    integrate

    +
    def integrate(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the integrate function in sympy.integrals

    +

    invert

    +
    def invert(
+    self,
+    g,
+    *gens,
+    **args
+)
+
    +

    Return the multiplicative inverse of self mod g

    +

    where self (and g) may be symbolic expressions).

    +

    See Also

    +

    sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert

    +

    is_algebraic_expr

    +
    def is_algebraic_expr(
+    self,
+    *syms
+)
+
    +

    This tests whether a given expression is algebraic or not, in the

    +

    given symbols, syms. When syms is not given, all free symbols +will be used. The rational function does not have to be in expanded +or in any kind of canonical form.

    +

    This function returns False for expressions that are "algebraic +expressions" with symbolic exponents. This is a simple extension to the +is_rational_function, including rational exponentiation.

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sqrt +x = Symbol('x', real=True) +sqrt(1 + x).is_rational_function() +False +sqrt(1 + x).is_algebraic_expr() +True

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be an algebraic +expression to become one.

    +
    +
    +
    +

    from sympy import exp, factor +a = sqrt(exp(x)*2 + 2exp(x) + 1)/(exp(x) + 1) +a.is_algebraic_expr(x) +False +factor(a).is_algebraic_expr() +True

    +
    +
    +
    +

    See Also

    +

    is_rational_function

    +

    References

    +

    .. [1] https://en.wikipedia.org/wiki/Algebraic_expression

    +

    is_constant

    +
    def is_constant(
+    self,
+    *wrt,
+    **flags
+)
+
    +

    Return True if self is constant, False if not, or None if

    +

    the constancy could not be determined conclusively.

    +

    Explanation

    +

    If an expression has no free symbols then it is a constant. If +there are free symbols it is possible that the expression is a +constant, perhaps (but not necessarily) zero. To test such +expressions, a few strategies are tried:

    +

    1) numerical evaluation at two random points. If two such evaluations +give two different values and the values have a precision greater than +1 then self is not constant. If the evaluations agree or could not be +obtained with any precision, no decision is made. The numerical testing +is done only if wrt is different than the free symbols.

    +

    2) differentiation with respect to variables in 'wrt' (or all free +symbols if omitted) to see if the expression is constant or not. This +will not always lead to an expression that is zero even though an +expression is constant (see added test in test_expr.py). If +all derivatives are zero then self is constant with respect to the +given symbols.

    +

    3) finding out zeros of denominator expression with free_symbols. +It will not be constant if there are zeros. It gives more negative +answers for expression that are not constant.

    +

    If neither evaluation nor differentiation can prove the expression is +constant, None is returned unless two numerical values happened to be +the same and the flag failing_number is True -- in that case the +numerical value will be returned.

    +

    If flag simplify=False is passed, self will not be simplified; +the default is True since self should be simplified before testing.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, sin, Sum, S, pi +from sympy.abc import a, n, x, y +x.is_constant() +False +S(2).is_constant() +True +Sum(x, (x, 1, 10)).is_constant() +True +Sum(x, (x, 1, n)).is_constant() +False +Sum(x, (x, 1, n)).is_constant(y) +True +Sum(x, (x, 1, n)).is_constant(n) +False +Sum(x, (x, 1, n)).is_constant(x) +True +eq = acos(x)2 + asin(x)**2 - a +eq.is_constant() +True +eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 +True

    +

    (0x).is_constant() +False +x.is_constant() +False +(xx).is_constant() +False +one = cos(x)2 + sin(x)2 +one.is_constant() +True +((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 +True

    +
    +
    +
    +

    is_hypergeometric

    +
    def is_hypergeometric(
+    self,
+    k
+)
+
    +

    is_meromorphic

    +
    def is_meromorphic(
+    self,
+    x,
+    a
+)
+
    +

    This tests whether an expression is meromorphic as

    +

    a function of the given symbol x at the point a.

    +

    This method is intended as a quick test that will return +None if no decision can be made without simplification or +more detailed analysis.

    +

    Examples

    +
    +
    +
    +

    from sympy import zoo, log, sin, sqrt +from sympy.abc import x

    +

    f = 1/x2 + 1 - 2*x3 +f.is_meromorphic(x, 0) +True +f.is_meromorphic(x, 1) +True +f.is_meromorphic(x, zoo) +True

    +

    g = x**log(3) +g.is_meromorphic(x, 0) +False +g.is_meromorphic(x, 1) +True +g.is_meromorphic(x, zoo) +False

    +

    h = sin(1/x)x*2 +h.is_meromorphic(x, 0) +False +h.is_meromorphic(x, 1) +True +h.is_meromorphic(x, zoo) +True

    +
    +
    +
    +

    Multivalued functions are considered meromorphic when their +branches are meromorphic. Thus most functions are meromorphic +everywhere except at essential singularities and branch points. +In particular, they will be meromorphic also on branch cuts +except at their endpoints.

    +
    +
    +
    +

    log(x).is_meromorphic(x, -1) +True +log(x).is_meromorphic(x, 0) +False +sqrt(x).is_meromorphic(x, -1) +True +sqrt(x).is_meromorphic(x, 0) +False

    +
    +
    +
    +

    is_polynomial

    +
    def is_polynomial(
+    self,
+    *syms
+)
+
    +

    Return True if self is a polynomial in syms and False otherwise.

    +

    This checks if self is an exact polynomial in syms. This function +returns False for expressions that are "polynomials" with symbolic +exponents. Thus, you should be able to apply polynomial algorithms to +expressions for which this returns True, and Poly(expr, *syms) should +work if and only if expr.is_polynomial(*syms) returns True. The +polynomial does not have to be in expanded form. If no symbols are +given, all free symbols in the expression will be used.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', polynomial=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, Function +x = Symbol('x') +((x2 + 1)4).is_polynomial(x) +True +((x2 + 1)4).is_polynomial() +True +(2x + 1).is_polynomial(x) +False +(2x + 1).is_polynomial(2**x) +True +f = Function('f') +(f(x) + 1).is_polynomial(x) +False +(f(x) + 1).is_polynomial(f(x)) +True +(1/f(x) + 1).is_polynomial(f(x)) +False

    +

    n = Symbol('n', nonnegative=True, integer=True) +(x**n + 1).is_polynomial(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a polynomial to +become one.

    +
    +
    +
    +

    from sympy import sqrt, factor, cancel +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1) +a.is_polynomial(y) +False +factor(a) +y + 1 +factor(a).is_polynomial(y) +True

    +

    b = (y*2 + 2y + 1)/(y + 1) +b.is_polynomial(y) +False +cancel(b) +y + 1 +cancel(b).is_polynomial(y) +True

    +
    +
    +
    +

    See also .is_rational_function()

    +

    is_rational_function

    +
    def is_rational_function(
+    self,
+    *syms
+)
+
    +

    Test whether function is a ratio of two polynomials in the given

    +

    symbols, syms. When syms is not given, all free symbols will be used. +The rational function does not have to be in expanded or in any kind of +canonical form.

    +

    This function returns False for expressions that are "rational +functions" with symbolic exponents. Thus, you should be able to call +.as_numer_denom() and apply polynomial algorithms to the result for +expressions for which this returns True.

    +

    This is not part of the assumptions system. You cannot do +Symbol('z', rational_function=True).

    +

    Examples

    +
    +
    +
    +

    from sympy import Symbol, sin +from sympy.abc import x, y

    +

    (x/y).is_rational_function() +True

    +

    (x**2).is_rational_function() +True

    +

    (x/sin(y)).is_rational_function(y) +False

    +

    n = Symbol('n', integer=True) +(x**n + 1).is_rational_function(x) +False

    +
    +
    +
    +

    This function does not attempt any nontrivial simplifications that may +result in an expression that does not appear to be a rational function +to become one.

    +
    +
    +
    +

    from sympy import sqrt, factor +y = Symbol('y', positive=True) +a = sqrt(y*2 + 2y + 1)/y +a.is_rational_function(y) +False +factor(a) +(y + 1)/y +factor(a).is_rational_function(y) +True

    +
    +
    +
    +

    See also is_algebraic_expr().

    +

    is_same

    +
    def is_same(
+    a,
+    b,
+    approx=None
+)
+
    +

    Return True if a and b are structurally the same, else False.

    +

    If approx is supplied, it will be used to test whether two +numbers are the same or not. By default, only numbers of the +same type will compare equal, so S.Half != Float(0.5).

    +

    Examples

    +

    In SymPy (unlike Python) two numbers do not compare the same if they are +not of the same type:

    +
    +
    +
    +

    from sympy import S +2.0 == S(2) +False +0.5 == S.Half +False

    +
    +
    +
    +

    By supplying a function with which to compare two numbers, such +differences can be ignored. e.g. equal_valued will return True +for decimal numbers having a denominator that is a power of 2, +regardless of precision.

    +
    +
    +
    +

    from sympy import Float +from sympy.core.numbers import equal_valued +(S.Half/4).is_same(Float(0.125, 1), equal_valued) +True +Float(1, 2).is_same(Float(1, 10), equal_valued) +True

    +
    +
    +
    +

    But decimals without a power of 2 denominator will compare +as not being the same.

    +
    +
    +
    +

    Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) +False

    +
    +
    +
    +

    But arbitrary differences can be ignored by supplying a function +to test the equivalence of two numbers:

    +
    +
    +
    +

    import math +Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) +True

    +
    +
    +
    +

    Other objects might compare the same even though types are not the +same. This routine will only return True if two expressions are +identical in terms of class types.

    +
    +
    +
    +

    from sympy import eye, Basic +eye(1) == S(eye(1)) # mutable vs immutable +True +Basic.is_same(eye(1), S(eye(1))) +False

    +
    +
    +
    +

    leadterm

    +
    def leadterm(
+    self,
+    x,
+    logx=None,
+    cdir=0
+)
+
    +

    Returns the leading term ax*b as a tuple (a, b).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(1+x+x2).leadterm(x) +(1, 0) +(1/x2+x+x**2).leadterm(x) +(1, -2)

    +
    +
    +
    +

    limit

    +
    def limit(
+    self,
+    x,
+    xlim,
+    dir='+'
+)
+
    +

    Compute limit x->xlim.

    +

    lseries

    +
    def lseries(
+    self,
+    x=None,
+    x0=0,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper for series yielding an iterator of the terms of the series.

    +

    Note: an infinite series will yield an infinite iterator. The following, +for exaxmple, will never terminate. It will just keep printing terms +of the sin(x) series::

    +

    for term in sin(x).lseries(x): + print term

    +

    The advantage of lseries() over nseries() is that many times you are +just interested in the next term in the series (i.e. the first term for +example), but you do not know how many you should ask for in nseries() +using the "n" parameter.

    +

    See also nseries().

    +

    match

    +
    def match(
+    self,
+    pattern,
+    old=False
+)
+
    +

    Pattern matching.

    +

    Wild symbols match all.

    +

    Return None when expression (self) does not match +with pattern. Otherwise return a dictionary such that::

    +

    pattern.xreplace(self.match(pattern)) == self

    +

    Examples

    +
    +
    +
    +

    from sympy import Wild, Sum +from sympy.abc import x, y +p = Wild("p") +q = Wild("q") +r = Wild("r") +e = (x+y)(x+y) +e.match(pp) +{p_: x + y} +e.match(pq) +{p_: x + y, q_: x + y} +e = (2*x)2 +e.match(pqr) +{p_: 4, q_: x, r_: 2} +(pqr).xreplace(e.match(p*qr)) +4x*2

    +
    +
    +
    +

    Structurally bound symbols are ignored during matching:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) +{p_: 2}

    +
    +
    +
    +

    But they can be identified if desired:

    +
    +
    +
    +

    Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) +{p_: 2, q_: x}

    +
    +
    +
    +

    The old flag will give the old-style pattern matching where +expressions and patterns are essentially solved to give the +match. Both of the following give None unless old=True:

    +
    +
    +
    +

    (x - 2).match(p - x, old=True) +{p_: 2x - 2} +(2/x).match(px, old=True) +{p_: 2/x**2}

    +
    +
    +
    +

    matches

    +
    def matches(
+    self,
+    expr,
+    repl_dict=None,
+    old=False
+)
+
    +

    Helper method for match() that looks for a match between Wild symbols

    +

    in self and expressions in expr.

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, Wild, Basic +a, b, c = symbols('a b c') +x = Wild('x') +Basic(a + x, x).matches(Basic(a + b, c)) is None +True +Basic(a + x, x).matches(Basic(a + b + c, b + c)) +{x_: b + c}

    +
    +
    +
    +

    n

    +
    def n(
+    self,
+    n=15,
+    subs=None,
+    maxn=100,
+    chop=False,
+    strict=False,
+    quad=None,
+    verbose=False
+)
+
    +

    Evaluate the given formula to an accuracy of n digits.

    +

    Parameters

    +

    subs : dict, optional + Substitute numerical values for symbols, e.g. + subs={x:3, y:1+pi}. The substitutions must be given as a + dictionary.

    +

    maxn : int, optional + Allow a maximum temporary working precision of maxn digits.

    +

    chop : bool or number, optional + Specifies how to replace tiny real or imaginary parts in + subresults by exact zeros.

    +
    When ``True`` the chop value defaults to standard precision.
+
+Otherwise the chop value is used to determine the
+magnitude of "small" for purposes of chopping.
+
+>>> from sympy import N
+>>> x = 1e-4
+>>> N(x, chop=True)
+0.000100000000000000
+>>> N(x, chop=1e-5)
+0.000100000000000000
+>>> N(x, chop=1e-4)
+0
+
    +

    strict : bool, optional + Raise PrecisionExhausted if any subresult fails to + evaluate to full accuracy, given the available maxprec.

    +

    quad : str, optional + Choose algorithm for numerical quadrature. By default, + tanh-sinh quadrature is used. For oscillatory + integrals on an infinite interval, try quad='osc'.

    +

    verbose : bool, optional + Print debug information.

    +

    Notes

    +

    When Floats are naively substituted into an expression, +precision errors may adversely affect the result. For example, +adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is +then subtracted, the result will be 0. +That is exactly what happens in the following:

    +
    +
    +
    +

    from sympy.abc import x, y, z +values = {x: 1e16, y: 1, z: 1e16} +(x + y - z).subs(values) +0

    +
    +
    +
    +

    Using the subs argument for evalf is the accurate way to +evaluate such an expression:

    +
    +
    +
    +

    (x + y - z).evalf(subs=values) +1.00000000000000

    +
    +
    +
    +

    normal

    +
    def normal(
+    self
+)
+
    +

    Return the expression as a fraction.

    +

    expression -> a/b

    +

    See Also

    +

    as_numer_denom: return (a, b) instead of a/b

    +

    nseries

    +
    def nseries(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Wrapper to _eval_nseries if assumptions allow, else to series.

    +

    If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is +called. This calculates "n" terms in the innermost expressions and +then builds up the final series just by "cross-multiplying" everything +out.

    +

    The optional logx parameter can be used to replace any log(x) in the +returned series with a symbolic value to avoid evaluating log(x) at 0. A +symbol to use in place of log(x) should be provided.

    +

    Advantage -- it's fast, because we do not have to determine how many +terms we need to calculate in advance.

    +

    Disadvantage -- you may end up with less terms than you may have +expected, but the O(x**n) term appended will always be correct and +so the result, though perhaps shorter, will also be correct.

    +

    If any of those assumptions is not met, this is treated like a +wrapper to series which will try harder to return the correct +number of terms.

    +

    See also lseries().

    +

    Examples

    +
    +
    +
    +

    from sympy import sin, log, Symbol +from sympy.abc import x, y +sin(x).nseries(x, 0, 6) +x - x3/6 + x5/120 + O(x6) +log(x+1).nseries(x, 0, 5) +x - x2/2 + x3/3 - x4/4 + O(x**5)

    +
    +
    +
    +

    Handling of the logx parameter --- in the following example the +expansion fails since sin does not have an asymptotic expansion +at -oo (the limit of log(x) as x approaches 0):

    +
    +
    +
    +

    e = sin(log(x)) +e.nseries(x, 0, 6) +Traceback (most recent call last): +... +PoleError: ... +... +logx = Symbol('logx') +e.nseries(x, 0, 6, logx=logx) +sin(logx)

    +
    +
    +
    +

    In the following example, the expansion works but only returns self +unless the logx parameter is used:

    +
    +
    +
    +

    e = xy +e.nseries(x, 0, 2) +xy +e.nseries(x, 0, 2, logx=logx) +exp(logx*y)

    +
    +
    +
    +

    nsimplify

    +
    def nsimplify(
+    self,
+    constants=(),
+    tolerance=None,
+    full=False
+)
+
    +

    See the nsimplify function in sympy.simplify

    +

    powsimp

    +
    def powsimp(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the powsimp function in sympy.simplify

    +

    primitive

    +
    def primitive(
+    self
+)
+
    +

    Return the positive Rational that can be extracted non-recursively

    +

    from every term of self (i.e., self is treated like an Add). This is +like the as_coeff_Mul() method but primitive always extracts a positive +Rational (never a negative or a Float).

    +

    Examples

    +
    +
    +
    +

    from sympy.abc import x +(3(x + 1)2).primitive() +(3, (x + 1)2) +a = (6x + 2); a.primitive() +(2, 3x + 1) +b = (x/2 + 3); b.primitive() +(1/2, x + 6) +(ab).primitive() == (1, a*b) +True

    +
    +
    +
    +

    radsimp

    +
    def radsimp(
+    self,
+    **kwargs
+)
+
    +

    See the radsimp function in sympy.simplify

    +

    ratsimp

    +
    def ratsimp(
+    self
+)
+
    +

    See the ratsimp function in sympy.simplify

    +

    rcall

    +
    def rcall(
+    self,
+    *args
+)
+
    +

    Apply on the argument recursively through the expression tree.

    +

    This method is used to simulate a common abuse of notation for +operators. For instance, in SymPy the following will not work:

    +

    (x+Lambda(y, 2*y))(z) == x+2*z,

    +

    however, you can use:

    +
    +
    +
    +

    from sympy import Lambda +from sympy.abc import x, y, z +(x + Lambda(y, 2y)).rcall(z) +x + 2z

    +
    +
    +
    +

    refine

    +
    def refine(
+    self,
+    assumption=True
+)
+
    +

    See the refine function in sympy.assumptions

    +

    removeO

    +
    def removeO(
+    self
+)
+
    +

    Removes the additive O(..) symbol if there is one

    +

    replace

    +
    def replace(
+    self,
+    query,
+    value,
+    map=False,
+    simultaneous=True,
+    exact=None
+)
+
    +

    Replace matching subexpressions of self with value.

    +

    If map = True then also return the mapping {old: new} where old +was a sub-expression found with query and new is the replacement +value for it. If the expression itself does not match the query, then +the returned value will be self.xreplace(map) otherwise it should +be self.subs(ordered(map.items())).

    +

    Traverses an expression tree and performs replacement of matching +subexpressions from the bottom to the top of the tree. The default +approach is to do the replacement in a simultaneous fashion so +changes made are targeted only once. If this is not desired or causes +problems, simultaneous can be set to False.

    +

    In addition, if an expression containing more than one Wild symbol +is being used to match subexpressions and the exact flag is None +it will be set to True so the match will only succeed if all non-zero +values are received for each Wild that appears in the match pattern. +Setting this to False accepts a match of 0; while setting it True +accepts all matches that have a 0 in them. See example below for +cautions.

    +

    The list of possible combinations of queries and replacement values +is listed below:

    +

    Examples

    +

    Initial setup

    +
    +
    +
    +

    from sympy import log, sin, cos, tan, Wild, Mul, Add +from sympy.abc import x, y +f = log(sin(x)) + tan(sin(x**2))

    +
    +
    +
    +

    1.1. type -> type + obj.replace(type, newtype)

    +
    When object of type ``type`` is found, replace it with the
+result of passing its argument(s) to ``newtype``.
+
+>>> f.replace(sin, cos)
+log(cos(x)) + tan(cos(x**2))
+>>> sin(x).replace(sin, cos, map=True)
+(cos(x), {sin(x): cos(x)})
+>>> (x*y).replace(Mul, Add)
+x + y
+
    +

    1.2. type -> func + obj.replace(type, func)

    +
    When object of type ``type`` is found, apply ``func`` to its
+argument(s). ``func`` must be written to handle the number
+of arguments of ``type``.
+
+>>> f.replace(sin, lambda arg: sin(2*arg))
+log(sin(2*x)) + tan(sin(2*x**2))
+>>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args)))
+sin(2*x*y)
+
    +

    2.1. pattern -> expr + obj.replace(pattern(wild), expr(wild))

    +
    Replace subexpressions matching ``pattern`` with the expression
+written in terms of the Wild symbols in ``pattern``.
+
+>>> a, b = map(Wild, 'ab')
+>>> f.replace(sin(a), tan(a))
+log(tan(x)) + tan(tan(x**2))
+>>> f.replace(sin(a), tan(a/2))
+log(tan(x/2)) + tan(tan(x**2/2))
+>>> f.replace(sin(a), a)
+log(x) + tan(x**2)
+>>> (x*y).replace(a*x, a)
+y
+
+Matching is exact by default when more than one Wild symbol
+is used: matching fails unless the match gives non-zero
+values for all Wild symbols:
+
+>>> (2*x + y).replace(a*x + b, b - a)
+y - 2
+>>> (2*x).replace(a*x + b, b - a)
+2*x
+
+When set to False, the results may be non-intuitive:
+
+>>> (2*x).replace(a*x + b, b - a, exact=False)
+2/x
+
    +

    2.2. pattern -> func + obj.replace(pattern(wild), lambda wild: expr(wild))

    +
    All behavior is the same as in 2.1 but now a function in terms of
+pattern variables is used rather than an expression:
+
+>>> f.replace(sin(a), lambda a: sin(2*a))
+log(sin(2*x)) + tan(sin(2*x**2))
+
    +

    3.1. func -> func + obj.replace(filter, func)

    +
    Replace subexpression ``e`` with ``func(e)`` if ``filter(e)``
+is True.
+
+>>> g = 2*sin(x**3)
+>>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2)
+4*sin(x**9)
+
    +

    The expression itself is also targeted by the query but is done in +such a fashion that changes are not made twice.

    +
    >>> e = x*(x*y + 1)
+>>> e.replace(lambda x: x.is_Mul, lambda x: 2*x)
+2*x*(2*x*y + 1)
+
    +

    When matching a single symbol, exact will default to True, but +this may or may not be the behavior that is desired:

    +

    Here, we want exact=False:

    +
    +
    +
    +

    from sympy import Function +f = Function('f') +e = f(1) + f(0) +q = f(a), lambda a: f(a + 1) +e.replace(q, exact=False) +f(1) + f(2) +e.replace(q, exact=True) +f(0) + f(2)

    +
    +
    +
    +

    But here, the nature of matching makes selecting +the right setting tricky:

    +
    +
    +
    +

    e = x(1 + y) +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=False) +x +(x(1 + y)).replace(x(1 + a), lambda a: x-a, exact=True) +x(-x - y + 1) +(xy).replace(x(1 + a), lambda a: x-a, exact=False) +x +(xy).replace(x(1 + a), lambda a: x-a, exact=True) +x**(1 - y)

    +
    +
    +
    +

    It is probably better to use a different form of the query +that describes the target expression more precisely:

    +
    +
    +
    +

    (1 + x(1 + y)).replace( +... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, +... lambda x: x.base(1 - (x.exp - 1))) +... +x**(1 - y) + 1

    +
    +
    +
    +

    See Also

    +

    subs: substitution of subexpressions as defined by the objects + themselves. +xreplace: exact node replacement in expr tree; also capable of + using matching rules

    +

    rewrite

    +
    def rewrite(
+    self,
+    *args,
+    deep=True,
+    **hints
+)
+
    +

    Rewrite self using a defined rule.

    +

    Rewriting transforms an expression to another, which is mathematically +equivalent but structurally different. For example you can rewrite +trigonometric functions as complex exponentials or combinatorial +functions as gamma function.

    +

    This method takes a pattern and a rule as positional arguments. +pattern is optional parameter which defines the types of expressions +that will be transformed. If it is not passed, all possible expressions +will be rewritten. rule defines how the expression will be rewritten.

    +

    Parameters

    +

    args : Expr + A rule, or pattern and rule. + - pattern is a type or an iterable of types. + - rule can be any object.

    +

    deep : bool, optional + If True, subexpressions are recursively transformed. Default is + True.

    +

    Examples

    +

    If pattern is unspecified, all possible expressions are transformed.

    +
    +
    +
    +

    from sympy import cos, sin, exp, I +from sympy.abc import x +expr = cos(x) + Isin(x) +expr.rewrite(exp) +exp(Ix)

    +
    +
    +
    +

    Pattern can be a type or an iterable of types.

    +
    +
    +
    +

    expr.rewrite(sin, exp) +exp(Ix)/2 + cos(x) - exp(-Ix)/2 +expr.rewrite([cos,], exp) +exp(Ix)/2 + Isin(x) + exp(-Ix)/2 +expr.rewrite([cos, sin], exp) +exp(Ix)

    +
    +
    +
    +

    Rewriting behavior can be implemented by defining _eval_rewrite() +method.

    +
    +
    +
    +

    from sympy import Expr, sqrt, pi +class MySin(Expr): +... def _eval_rewrite(self, rule, args, hints): +... x, = args +... if rule == cos: +... return cos(pi/2 - x, evaluate=False) +... if rule == sqrt: +... return sqrt(1 - cos(x)2) +MySin(MySin(x)).rewrite(cos) +cos(-cos(-x + pi/2) + pi/2) +MySin(x).rewrite(sqrt) +sqrt(1 - cos(x)**2)

    +
    +
    +
    +

    Defining _eval_rewrite_as_[...]() method is supported for backwards +compatibility reason. This may be removed in the future and using it is +discouraged.

    +
    +
    +
    +

    class MySin(Expr): +... def _eval_rewrite_as_cos(self, args, *hints): +... x, = args +... return cos(pi/2 - x, evaluate=False) +MySin(x).rewrite(cos) +cos(-x + pi/2)

    +
    +
    +
    +

    round

    +
    def round(
+    self,
+    n=None
+)
+
    +

    Return x rounded to the given decimal place.

    +

    If a complex number would results, apply round to the real +and imaginary components of the number.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, E, I, S, Number +pi.round() +3 +pi.round(2) +3.14 +(2pi + EI).round() +6 + 3*I

    +
    +
    +
    +

    The round method has a chopping effect:

    +
    +
    +
    +

    (2pi + I/10).round() +6 +(pi/10 + 2I).round() +2I +(pi/10 + EI).round(2) +0.31 + 2.72*I

    +
    +
    +
    +

    Notes

    +

    The Python round function uses the SymPy round method so it +will always return a SymPy number (not a Python float or int):

    +
    +
    +
    +

    isinstance(round(S(123), -2), Number) +True

    +
    +
    +
    +

    separate

    +
    def separate(
+    self,
+    deep=False,
+    force=False
+)
+
    +

    See the separate function in sympy.simplify

    +

    series

    +
    def series(
+    self,
+    x=None,
+    x0=0,
+    n=6,
+    dir='+',
+    logx=None,
+    cdir=0
+)
+
    +

    Series expansion of "self" around x = x0 yielding either terms of

    +

    the series one by one (the lazy series given when n=None), else +all the terms at once when n != None.

    +

    Returns the series expansion of "self" around the point x = x0 +with respect to x up to O((x - x0)**n, x, x0) (default n is 6).

    +

    If x=None and self is univariate, the univariate symbol will +be supplied, otherwise an error will be raised.

    +

    Parameters

    +

    expr : Expression + The expression whose series is to be expanded.

    +

    x : Symbol + It is the variable of the expression to be calculated.

    +

    x0 : Value + The value around which x is calculated. Can be any value + from -oo to oo.

    +

    n : Value + The value used to represent the order in terms of x**n, + up to which the series is to be expanded.

    +

    dir : String, optional + The series-expansion can be bi-directional. If dir="+", + then (x->x0+). If dir="-", then (x->x0-). For infinitex0(ooor-oo), thedirargument is determined + from the direction of the infinity (i.e.,dir="-"foroo``).

    +

    logx : optional + It is used to replace any log(x) in the returned series with a + symbolic value rather than evaluating the actual value.

    +

    cdir : optional + It stands for complex direction, and indicates the direction + from which the expansion needs to be evaluated.

    +

    Examples

    +
    +
    +
    +

    from sympy import cos, exp, tan +from sympy.abc import x, y +cos(x).series() +1 - x2/2 + x4/24 + O(x6) +cos(x).series(n=4) +1 - x2/2 + O(x4) +cos(x).series(x, x0=1, n=2) +cos(1) - (x - 1)*sin(1) + O((x - 1)2, (x, 1)) +e = cos(x + exp(y)) +e.series(y, n=2) +cos(x + 1) - ysin(x + 1) + O(y2) +e.series(x, n=2) +cos(exp(y)) - xsin(exp(y)) + O(x**2)

    +
    +
    +
    +

    If n=None then a generator of the series terms will be returned.

    +
    +
    +
    +

    term=cos(x).series(n=None) +[next(term) for i in range(2)] +[1, -x**2/2]

    +
    +
    +
    +

    For dir=+ (default) the series is calculated from the right and +for dir=- the series from the left. For smooth functions this +flag will not alter the results.

    +
    +
    +
    +

    abs(x).series(dir="+") +x +abs(x).series(dir="-") +-x +f = tan(x) +f.series(x, 2, 6, "+") +tan(2) + (1 + tan(2)2)*(x - 2) + (x - 2)2(tan(2)3 + tan(2)) + +(x - 2)3(1/3 + 4tan(2)2/3 + tan(2)4) + (x - 2)4(tan(2)5 + +5*tan(2)3/3 + 2tan(2)/3) + (x - 2)5(2/15 + 17tan(2)2/15 + +2tan(2)4 + tan(2)6) + O((x - 2)**6, (x, 2))

    +

    f.series(x, 2, 3, "-") +tan(2) + (2 - x)(-tan(2)2 - 1) + (2 - x)2(tan(2)3 + tan(2)) ++ O((x - 2)3, (x, 2))

    +
    +
    +
    +

    For rational expressions this method may return original expression without the Order term.

    +
    +
    +
    +

    (1/x).series(x, n=8) +1/x

    +
    +
    +
    +

    Returns

    +

    Expr : Expression + Series expansion of the expression about x0

    +

    Raises

    +

    TypeError + If "n" and "x0" are infinity objects

    +

    PoleError + If "x0" is an infinity object

    +

    simplify

    +
    def simplify(
+    self,
+    **kwargs
+)
+
    +

    See the simplify function in sympy.simplify

    +

    sort_key

    +
    def sort_key(
+    self,
+    order=None
+)
+
    +

    Return a sort key.

    +

    Examples

    +
    +
    +
    +

    from sympy import S, I

    +

    sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) +[1/2, -I, I]

    +

    S("[x, 1/x, 1/x2, x2, x(1/2), x(1/4), x(3/2)]") +[x, 1/x, x(-2), x2, sqrt(x), x(1/4), x(3/2)] +sorted(_, key=lambda x: x.sort_key()) +[x(-2), 1/x, x(1/4), sqrt(x), x, x(3/2), x**2]

    +
    +
    +
    +

    subs

    +
    def subs(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    Substitutes old for new in an expression after sympifying args.

    +

    args is either: + - two arguments, e.g. foo.subs(old, new) + - one iterable argument, e.g. foo.subs(iterable). The iterable may be + o an iterable container with (old, new) pairs. In this case the + replacements are processed in the order given with successive + patterns possibly affecting replacements already made. + o a dict or set whose key/value items correspond to old/new pairs. + In this case the old/new pairs will be sorted by op count and in + case of a tie, by number of args and the default_sort_key. The + resulting sorted list is then processed as an iterable container + (see previous).

    +

    If the keyword simultaneous is True, the subexpressions will not be +evaluated until all the substitutions have been made.

    +

    Examples

    +
    +
    +
    +

    from sympy import pi, exp, limit, oo +from sympy.abc import x, y +(1 + xy).subs(x, pi) +piy + 1 +(1 + xy).subs({x:pi, y:2}) +1 + 2pi +(1 + xy).subs([(x, pi), (y, 2)]) +1 + 2pi +reps = [(y, x2), (x, 2)] +(x + y).subs(reps) +6 +(x + y).subs(reversed(reps)) +x2 + 2

    +

    (x2 + x4).subs(x2, y) +y2 + y

    +
    +
    +
    +

    To replace only the x2 but not the x4, use xreplace:

    +
    +
    +
    +

    (x2 + x4).xreplace({x2: y}) +x4 + y

    +
    +
    +
    +

    To delay evaluation until all substitutions have been made, +set the keyword simultaneous to True:

    +
    +
    +
    +

    (x/y).subs([(x, 0), (y, 0)]) +0 +(x/y).subs([(x, 0), (y, 0)], simultaneous=True) +nan

    +
    +
    +
    +

    This has the added feature of not allowing subsequent substitutions +to affect those already made:

    +
    +
    +
    +

    ((x + y)/y).subs({x + y: y, y: x + y}) +1 +((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) +y/(x + y)

    +
    +
    +
    +

    In order to obtain a canonical result, unordered iterables are +sorted by count_op length, number of arguments and by the +default_sort_key to break any ties. All other iterables are left +unsorted.

    +
    +
    +
    +

    from sympy import sqrt, sin, cos +from sympy.abc import a, b, c, d, e

    +

    A = (sqrt(sin(2x)), a) +B = (sin(2x), b) +C = (cos(2*x), c) +D = (x, d) +E = (exp(x), e)

    +

    expr = sqrt(sin(2x))sin(exp(x)x)cos(2x) + sin(2x)

    +

    expr.subs(dict([A, B, C, D, E])) +acsin(d*e) + b

    +
    +
    +
    +

    The resulting expression represents a literal replacement of the +old arguments with the new arguments. This may not reflect the +limiting behavior of the expression:

    +
    +
    +
    +

    (x*3 - 3x).subs({x: oo}) +nan

    +

    limit(x*3 - 3x, x, oo) +oo

    +
    +
    +
    +

    If the substitution will be followed by numerical +evaluation, it is better to pass the substitution to +evalf as

    +
    +
    +
    +

    (1/x).evalf(subs={x: 3.0}, n=21) +0.333333333333333333333

    +
    +
    +
    +

    rather than

    +
    +
    +
    +

    (1/x).subs({x: 3.0}).evalf(21) +0.333333333333333314830

    +
    +
    +
    +

    as the former will ensure that the desired level of precision is +obtained.

    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +xreplace: exact node replacement in expr tree; also capable of + using matching rules +sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision

    +

    taylor_term

    +
    def taylor_term(
+    self,
+    n,
+    x,
+    *previous_terms
+)
+
    +

    General method for the taylor term.

    +

    This method is slow, because it differentiates n-times. Subclasses can +redefine it to make it faster by using the "previous_terms".

    +

    to_nnf

    +
    def to_nnf(
+    self,
+    simplify=True
+)
+
    +

    together

    +
    def together(
+    self,
+    *args,
+    **kwargs
+)
+
    +

    See the together function in sympy.polys

    +

    transpose

    +
    def transpose(
+    self
+)
+
    +

    trigsimp

    +
    def trigsimp(
+    self,
+    **args
+)
+
    +

    See the trigsimp function in sympy.simplify

    +

    xreplace

    +
    def xreplace(
+    self,
+    rule,
+    hack2=False
+)
+
    +

    Replace occurrences of objects within the expression.

    +

    Parameters

    +

    rule : dict-like + Expresses a replacement rule

    +

    Returns

    +

    xreplace : the result of the replacement

    +

    Examples

    +
    +
    +
    +

    from sympy import symbols, pi, exp +x, y, z = symbols('x y z') +(1 + xy).xreplace({x: pi}) +piy + 1 +(1 + xy).xreplace({x: pi, y: 2}) +1 + 2pi

    +
    +
    +
    +

    Replacements occur only if an entire node in the expression tree is +matched:

    +
    +
    +
    +

    (xy + z).xreplace({xy: pi}) +z + pi +(xyz).xreplace({xy: pi}) +xyz +(2x).xreplace({2x: y, x: z}) +y +(22x).xreplace({2x: y, x: z}) +4*z +(x + y + 2).xreplace({x + y: 2}) +x + y + 2 +(x + 2 + exp(x + 2)).xreplace({x + 2: y}) +x + exp(y) + 2

    +
    +
    +
    +

    xreplace does not differentiate between free and bound symbols. In the +following, subs(x, y) would not change x since it is a bound symbol, +but xreplace does:

    +
    +
    +
    +

    from sympy import Integral +Integral(x, (x, 1, 2x)).xreplace({x: y}) +Integral(y, (y, 1, 2y))

    +
    +
    +
    +

    Trying to replace x with an expression raises an error:

    +
    +
    +
    +

    Integral(x, (x, 1, 2x)).xreplace({x: 2y}) # doctest: +SKIP +ValueError: Invalid limits given: ((2y, 1, 4y),)

    +
    +
    +
    +

    See Also

    +

    replace: replacement capable of doing wildcard-like matching, + parsing of match, and conditional replacements +subs: substitution of subexpressions as defined by the objects + themselves.

    +

    Task

    +
    class Task(
+    name: 'str',
+    target: 'Lazy'
+)
+
    +

    Named wrapper of a lazy-evaluatable function.

    +

    Wraps a lazy-evaluatable function (dewret.workflow.Lazy) with any +metadata needed to render it later. At present, this is the name.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    nameNoneName of the lazy function as it will appear in the output workflow text.None
    targetNoneCallable that is wrapped.None
    +

    UnsetType

    +
    class UnsetType(
+    raw_type: 'type[T]'
+)
+
    +

    Unset variable with a specific type.

    +

    Attributes

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    typeNonetype of the variable.None
    +

    Ancestors (in MRO)

    +
      +
    • dewret.utils.Unset
      • +
    • typing.Generic
      • +
    +

    Workflow

    +
    class Workflow(
+    name: 'str | None' = None
+)
+
    +

    Overarching workflow concept.

    +

    Represents a whole workflow, as a singleton maintaining all +state information needed ahead of rendering. It is built up +as the lazy-evaluations are finally evaluated.

    +

    Attributes

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    stepsNonethe sequence of calls to lazy-evaluable functions,
    built as they are evaluated.    		None
    tasksNonethe mapping of names used in the steps to the actual
    Task wrappers they represent.    		None
    resultNonetarget reference to evaluate, if yet present.None
    +

    Static methods

    +

    assimilate

    +
    def assimilate(
+    *workflow_args: 'Workflow'
+) -> "'Workflow'"
+
    +

    Combine two Workflows into one Workflow.

    +

    Takes two workflows and unifies them by combining steps +and tasks. If it sees mismatched identifiers for the same +component, it will error. +This could happen if the hashing function is flawed +or some Python magic to do with Targets being passed.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    workflow_argsNoneworkflows to use as baseNone
    +

    from_result

    +
    def from_result(
+    result: 'StepReference[Any] | list[StepReference[Any]] | tuple[StepReference[Any], ...]',
+    simplify_ids: 'bool' = False,
+    nested: 'bool' = True
+) -> 'Workflow'
+
    +

    Create from a desired result.

    +

    Starts from a result, and builds a workflow to output it.

    +

    Instance variables

    +
    has_result
+
    +

    Confirms whether this workflow has a non-empty result.

    +

    Either None or an empty list/tuple are considered empty for this purpose.

    +

    Returns: True if the workflow has a result, False otherwise.

    +
    id
+
    +

    Consistent ID based off the step IDs.

    +
    indexed_steps
+
    +

    Steps mapped by ID.

    +

    Forces generation of IDs. Note that this effectively +freezes the steps, so it should not be used until we +are confident the steps are all ready to be hashed.

    +
    name
+
    +

    Get the name of the workflow.

    +
    result_type
+
    +

    Overall return type of this workflow.

    +
    steps
+
    +

    Get deduplicated steps.

    +

    Returns: steps for looping over without duplicates.

    +

    Methods

    +

    add_nested_step

    +
    def add_nested_step(
+    self,
+    name: 'str',
+    subworkflow: 'Workflow',
+    return_type: 'type | None',
+    kwargs: 'dict[str, Any]',
+    positional_args: 'dict[str, bool] | None' = None
+) -> 'StepReference[Any]'
+
    +

    Append a nested step.

    +

    Calls a subworkflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    nameNonename of the subworkflow.None
    subworkflowNonethe subworkflow itself.None
    return_typeNonea forced type for the return, or None.None
    kwargsNoneany key-value arguments to pass in the call.None
    positional_argsNonea mapping of arguments to bools, True if the argument is positional or otherwise False.None
    +

    add_step

    +
    def add_step(
+    self,
+    fn: 'Lazy',
+    kwargs: 'dict[str, Raw | Reference[Any]]',
+    raw_as_parameter: 'bool' = False,
+    is_factory: 'bool' = False,
+    positional_args: 'dict[str, bool] | None' = None
+) -> 'StepReference[Any]'
+
    +

    Append a step.

    +

    Adds a step, for running a target with key-value arguments, +to the workflow.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fnNonethe target function to turn into a step.None
    kwargsNoneany key-value arguments to pass in the call.None
    raw_as_parameterNonewhether to turn any discovered raw arguments into workflow parameters.None
    is_factoryNonewhether this step should be a Factory.None
    positional_argsNonea mapping of arguments to bools, True if the argument is positional or otherwise False.None
    +

    find_factories

    +
    def find_factories(
+    self
+) -> 'dict[str, FactoryCall]'
+
    +

    Steps that are factory calls.

    +

    find_parameters

    +
    def find_parameters(
+    self,
+    include_factory_calls: 'bool' = True
+) -> 'set[Parameter[Any]]'
+
    +

    Crawl steps for parameter references.

    +

    As the workflow does not hold its own list of parameters, this +dynamically finds them.

    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneSet of all references to parameters across the steps.
    +

    register_task

    +
    def register_task(
+    self,
+    fn: 'Lazy'
+) -> 'Task'
+
    +

    Note the existence of a lazy-evaluatable function, and wrap it as a Task.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    fnNonethe wrapped function.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneA new Task that wraps the function, and is retained in the Workflow.tasks
    dict.
    +

    remap

    +
    def remap(
+    self,
+    step_id: 'str'
+) -> 'str'
+
    +

    Apply name simplification if requested.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    step_idNonestep to check.None
    +

    Returns:

    + + + + + + + + + + + + + +
    TypeDescription
    NoneSame ID or a remapped name.
    +

    set_result

    +
    def set_result(
+    self,
+    result: 'Basic | list[Basic] | tuple[Basic]'
+) -> 'None'
+
    +

    Choose the result step.

    +

    Sets a step as being the result for the entire workflow. +When we evaluate a dynamic workflow, the engine (e.g. dask) +creates a graph to realize the result of a single collection. +Similarly, in the static case, we need to have a result that +drives the calculation.

    +

    Parameters:

    + + + + + + + + + + + + + + + + + +
    NameTypeDescriptionDefault
    resultNonereference to the chosen step.None
    +

    simplify_ids

    +
    def simplify_ids(
+    self,
+    infix: 'list[str] | None' = None
+) -> 'None'
+
    +

    Work out mapping to simple ints from hashes.

    +

    Goes through and numbers each step by the order of use of its task.

    +

    WorkflowLinkedComponent

    +
    class WorkflowLinkedComponent(
+    *args,
+    **kwargs
+)
+
    +

    Protocol for objects dynamically tied to a Workflow.

    +

    Ancestors (in MRO)

    +
      +
    • typing.Protocol
      • +
    • typing.Generic
      • +
    + + + + + + +
    +
    + + +
    + +
    + + + + +
    +
    +
    +
    + + + + + + + + + \ No newline at end of file diff --git a/search/search_index.json b/search/search_index.json new file mode 100644 index 00000000..5f8e3d2f --- /dev/null +++ b/search/search_index.json @@ -0,0 +1 @@ +{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"dewret DEclarative Workflow REndering Tool Pron : durr-it, like \"durable\" Introduction Dewret allows certain workflows written in a dynamic style to be rendered to a static representation. Advantages of doing so include: git-versionable workflows : while code can be versioned, the changes of a dynamic workflow do not necessarily clearly correspond to changes in the executed workflow. This maintains a precise trackable history. plan and play : the workflow can be rapidly iterated, analysed and optimized before it is sent for real execution on expensive or restricted HPC hardware. optimization : creating the workflow explicitly opens up possibilities for static analysis and refactoring before real execution. debugging : a number of classes of workflow planning bugs will not appear until late in a simulation run that might take days or weeks. This catches them before startup. continuous integration and testing : complex dynamic workflows can be rapidly sense-checked in CI without needing all the hardware and internal algorithms present to run them. Documentation For further information, see the documentation .","title":"Home"},{"location":"#dewret","text":"DEclarative Workflow REndering Tool Pron : durr-it, like \"durable\"","title":"dewret"},{"location":"#introduction","text":"Dewret allows certain workflows written in a dynamic style to be rendered to a static representation. Advantages of doing so include: git-versionable workflows : while code can be versioned, the changes of a dynamic workflow do not necessarily clearly correspond to changes in the executed workflow. This maintains a precise trackable history. plan and play : the workflow can be rapidly iterated, analysed and optimized before it is sent for real execution on expensive or restricted HPC hardware. optimization : creating the workflow explicitly opens up possibilities for static analysis and refactoring before real execution. debugging : a number of classes of workflow planning bugs will not appear until late in a simulation run that might take days or weeks. This catches them before startup. continuous integration and testing : complex dynamic workflows can be rapidly sense-checked in CI without needing all the hardware and internal algorithms present to run them.","title":"Introduction"},{"location":"#documentation","text":"For further information, see the documentation .","title":"Documentation"},{"location":"docs/glossary/","text":"Glossary Construct To construct a workflow in dewret is to pull the connected steps into a single structure. Sub Workflow A subworkflow is a nested or hierarchical workflow. It is a workflow defined within another workflow, allowing for the encapsulation and reuse of complex operations as a single, higher-level step in the parent workflow. Specific type of task designed to encapsulate multiple tasks. Nested tasks are the culmination (or result) of multiple tasks represented as a single task in a dewret workflow . Render To render a workflow is to generate an executable workflow in a specific workflow language such as CWL and Snakemake. Step A step in a dewret workflow represents a single unit of work. It contains a single task and the arguments for that task. Corresponds to a CWL Step or a Snakemake Rule Task A task is the function scheduled to be executed later. Corresponds to a CWL Process Workflow A workflow is designed to define, manage, and execute a series of tasks that make use of both local and global parameters.","title":"Glossary"},{"location":"docs/glossary/#glossary","text":"","title":"Glossary"},{"location":"docs/glossary/#construct","text":"To construct a workflow in dewret is to pull the connected steps into a single structure.","title":"Construct"},{"location":"docs/glossary/#sub-workflow","text":"A subworkflow is a nested or hierarchical workflow. It is a workflow defined within another workflow, allowing for the encapsulation and reuse of complex operations as a single, higher-level step in the parent workflow. Specific type of task designed to encapsulate multiple tasks. Nested tasks are the culmination (or result) of multiple tasks represented as a single task in a dewret workflow .","title":"Sub Workflow"},{"location":"docs/glossary/#render","text":"To render a workflow is to generate an executable workflow in a specific workflow language such as CWL and Snakemake.","title":"Render"},{"location":"docs/glossary/#step","text":"A step in a dewret workflow represents a single unit of work. It contains a single task and the arguments for that task. Corresponds to a CWL Step or a Snakemake Rule","title":"Step"},{"location":"docs/glossary/#task","text":"A task is the function scheduled to be executed later. Corresponds to a CWL Process","title":"Task"},{"location":"docs/glossary/#workflow","text":"A workflow is designed to define, manage, and execute a series of tasks that make use of both local and global parameters.","title":"Workflow"},{"location":"docs/quickstart/","text":"Quickstart Introduction Description Dewret is a tool designed for creating complex workflows, written in a dynamic style, to be rendered to a static representation. Dewret provides a programmatic python interface to multiple declarative workflow engines, where workflows are often written in a yaml-like syntax. It makes it easier for users to define tasks and organize them into workflows. Currently, Dewret supports two renderers: Snakemake and CWL, which generate yamls in the corresponding workflow languages. What are Workflows? Workflows are a collection of tasks or steps designed to automate complex processes. These processes are common in fields like data science, scientific computing and software development, where you can ensure automation. Traditionally, managing workflows can be challenging due to the diversity of backend systems and the complexity of configurations involved. What Makes Dewret Unique? Why should I use Dewret? Dewret stands out by providing a unified and simplified interface for workflow management, making it accessible to users with varying levels of experience. Here are some key features that make Dewret unique: - Consistency: offers a consistent interface for defining tasks and workflows. - Optimization: creating a declarative workflow opens up possibilities for static analysis and refactoring before execution. - Customization: dewret offers the ability to create custom renderers for workflows in desired languages. This includes default support for CWL and Snakemake workflow languages. The capability to render a single workflow into multiple declarative languages enables users to experiment with different workflow engines. - Git-versionable workflows: while code can be versioned, changes in a dynamic workflow may not clearly correspond to changes in the executed workflow. By defining a static workflow that is rendered from the dynamic or programmatic workflow, we maintain a precise and trackable history. - Default Renderers: Snakemake and CWL. - Debugging: a number of classes of workflow planning bugs will not appear until late in a simulation run that might take days or weeks. Having a declarative and static workflow definition document post-render provides enhanced possibilities for static analysis, helping to catch these issues before startup. - Continuous Integration and Testing: complex dynamic workflows can be rapidly sense-checked in CI without needing all the hardware and internal algorithms present to run them. Installation for pure users If you simply want to use Dewret to run workflows, you can install it from PyPI or Conda. From PyPI: pip install dewret From Conda: conda install conda-forge::dewret Installation for developers From a cloned repository: pip install -e . Usage You can render a simple Common Workflow Language CWL workflow from a graph composed of one or more tasks as follows: # workflow.py from dewret.tasks import task @task () def increment ( num : int ) -> int : return num + 1 $ python -m dewret --pretty workflow.py increment num:3 class : Workflow cwlVersion : 1.2 outputs : out : outputSource : increment-e138626779553199eb2bd678356b640f-num type : int steps : increment-e138626779553199eb2bd678356b640f-num in : num : default : 3 out : - out run : increment By default dewret uses a dask backend so that dewret.task wraps a dask.delayed , and renders a CWL workflow. Programmatic Usage Building and rendering may be done programmatically, which provides the opportunity to use custom renderers and backends, as well as bespoke serialization or formatting. >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 >>> >>> result = increment ( num = 3 ) >>> workflow = construct ( result , simplify_ids = True ) >>> cwl = render ( workflow )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : increment - 1 - num : default : 3 label : num type : int outputs : out : label : out outputSource : increment - 1 / out type : int steps : increment - 1 : in : num : source : increment - 1 - num out : - out run : increment","title":"Quickstart"},{"location":"docs/quickstart/#quickstart","text":"","title":"Quickstart"},{"location":"docs/quickstart/#introduction","text":"","title":"Introduction"},{"location":"docs/quickstart/#description","text":"Dewret is a tool designed for creating complex workflows, written in a dynamic style, to be rendered to a static representation. Dewret provides a programmatic python interface to multiple declarative workflow engines, where workflows are often written in a yaml-like syntax. It makes it easier for users to define tasks and organize them into workflows. Currently, Dewret supports two renderers: Snakemake and CWL, which generate yamls in the corresponding workflow languages.","title":"Description"},{"location":"docs/quickstart/#what-are-workflows","text":"Workflows are a collection of tasks or steps designed to automate complex processes. These processes are common in fields like data science, scientific computing and software development, where you can ensure automation. Traditionally, managing workflows can be challenging due to the diversity of backend systems and the complexity of configurations involved.","title":"What are Workflows?"},{"location":"docs/quickstart/#what-makes-dewret-unique-why-should-i-use-dewret","text":"Dewret stands out by providing a unified and simplified interface for workflow management, making it accessible to users with varying levels of experience. Here are some key features that make Dewret unique: - Consistency: offers a consistent interface for defining tasks and workflows. - Optimization: creating a declarative workflow opens up possibilities for static analysis and refactoring before execution. - Customization: dewret offers the ability to create custom renderers for workflows in desired languages. This includes default support for CWL and Snakemake workflow languages. The capability to render a single workflow into multiple declarative languages enables users to experiment with different workflow engines. - Git-versionable workflows: while code can be versioned, changes in a dynamic workflow may not clearly correspond to changes in the executed workflow. By defining a static workflow that is rendered from the dynamic or programmatic workflow, we maintain a precise and trackable history. - Default Renderers: Snakemake and CWL. - Debugging: a number of classes of workflow planning bugs will not appear until late in a simulation run that might take days or weeks. Having a declarative and static workflow definition document post-render provides enhanced possibilities for static analysis, helping to catch these issues before startup. - Continuous Integration and Testing: complex dynamic workflows can be rapidly sense-checked in CI without needing all the hardware and internal algorithms present to run them.","title":"What Makes Dewret Unique? Why should I use Dewret?"},{"location":"docs/quickstart/#installation-for-pure-users","text":"If you simply want to use Dewret to run workflows, you can install it from PyPI or Conda.","title":"Installation for pure users"},{"location":"docs/quickstart/#from-pypi","text":"pip install dewret","title":"From PyPI:"},{"location":"docs/quickstart/#from-conda","text":"conda install conda-forge::dewret","title":"From Conda:"},{"location":"docs/quickstart/#installation-for-developers","text":"From a cloned repository: pip install -e .","title":"Installation for developers"},{"location":"docs/quickstart/#usage","text":"You can render a simple Common Workflow Language CWL workflow from a graph composed of one or more tasks as follows: # workflow.py from dewret.tasks import task @task () def increment ( num : int ) -> int : return num + 1 $ python -m dewret --pretty workflow.py increment num:3 class : Workflow cwlVersion : 1.2 outputs : out : outputSource : increment-e138626779553199eb2bd678356b640f-num type : int steps : increment-e138626779553199eb2bd678356b640f-num in : num : default : 3 out : - out run : increment By default dewret uses a dask backend so that dewret.task wraps a dask.delayed , and renders a CWL workflow.","title":"Usage"},{"location":"docs/quickstart/#programmatic-usage","text":"Building and rendering may be done programmatically, which provides the opportunity to use custom renderers and backends, as well as bespoke serialization or formatting. >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 >>> >>> result = increment ( num = 3 ) >>> workflow = construct ( result , simplify_ids = True ) >>> cwl = render ( workflow )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : increment - 1 - num : default : 3 label : num type : int outputs : out : label : out outputSource : increment - 1 / out type : int steps : increment - 1 : in : num : source : increment - 1 - num out : - out run : increment","title":"Programmatic Usage"},{"location":"docs/renderer_tutorial/","text":"Step-by-Step Guide to Writing a Custom Renderer 1. Understand the Target Workflow Language Before writing any code, it is essential to fully understand the target workflow language. This includes syntax, structure, and specific requirements. By breaking down each key dewret.workflow task into smaller components, you can better map your workflow definitions to the target language. Example: In Snakemake, a workflow task is generally created by: 1. Defining the task. - rule process_data 2. Defining the input required for the rule to run(dependencies). - input: \"data/raw_data.txt\" 3. Defining the output required for the rule to be considered finished. - output: \"data/processed_data.txt\" 4. Defining the actual work that the task will do. - in this case: shell: ... rule process_data: # Example Snakemake rule/task input: \"data/raw_data.txt\" output: output_file = \"data/processed_data.txt\" run: with open ( output.output_file, \"w\" ) as f: f.write ( \"data\" ) return output_file 2. Create WorkflowDefinition. The WorkflowDefinition class is responsible for transforming each step from a constructed dewret workflow into an executable step in the target workflow language (e.g. a Snakemake rule). This class should encapsulate workflow-level information, such as the list of steps to be executed, and any workflow-scope input/ouput. It should also contain a class method that initializes the WorkflowDefinition from an dewret Workflow (such as from_workflow below), and a method that renders the workflow as a Python dict (as in the render method below). Example: @define class WorkflowDefinition : steps : list [ StepDefinition ] # Returns a WorkflowDefinition instanace. # Steps contains all of the tasks you want to convert to the target WL tasks. @classmethod def from_workflow ( cls , workflow : Workflow ) -> \"WorkflowDefinition\" : return cls ( steps = [ StepDefinition . from_step ( step ) for step in workflow . steps ]) # Returns each task as a Snakemake executable rule. def render ( self ) -> dict [ str , RawType ]: return { f \"rule { step . name . replace ( \"-\" , \"_\" ) } \" : step . render () for step in self . steps } 3. Ensuring Our Module is Recognized as a Render Module To have our custom renderer identified by Dewret as a valid renderer, we need to implement the BaseRenderModule along with one of the two protocols: RawRenderModule or StructuredRenderModule . Implementing BaseRenderModule The BaseRenderModule defines the foundation for a custom renderer. To implement this protocol, we need to define the default_config() method, which provides default configurations for our renderer. def default_config () -> CWLRendererConfiguration : \"\"\"Default configuration for this renderer. This is a hook-like call to give a configuration dict that this renderer will respect, and sets any necessary default values. Returns: a dict with (preferably) raw type structures to enable easy setting from YAML/JSON. \"\"\" return { \"allow_complex_types\" : False , \"factories_as_params\" : False , } After implementing BaseRenderModule , you need to implement either the RawRenderModule or StructuredRenderModule protocol, depending on how you want to handle the workflow rendering. Implementing either RawRenderModule or StructuredRenderModule The StructuredRenderModule is designed for structured workflows that are directly ready to be output in the respective format (e.g., CWL, Snakemake, etc.). The key method to implement is render , which converts a workflow into a structured, serializable format. def render ( self , workflow : WorkflowProtocol , ** kwargs : RenderConfiguration ) -> dict [ str , dict [ str , RawType ]]: \"\"\"Turn a workflow into a serializable structure. Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least. \"\"\" ... In this method: - You receive a workflow and potentially some optional configurations. - You return a dictionary where the __root__ key holds the primary workflow and any additional subworkflows are nested inside the returned structure. If you prefer more flexibility and want the structuring to be handled by the user, you can implement the RawRenderModule protocol. This requires defining the render_raw method, which converts a workflow into raw, flat strings. def render_raw ( self , workflow : WorkflowProtocol , ** kwargs : RenderConfiguration ) -> dict [ str , str ]: \"\"\"Turn a workflow into flat strings. Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least. \"\"\" ... In this method: The workflow is rendered as raw, unstructured strings. The user is responsible for handling the structuring of the rendered output. 4. Create a StepDefinition. Create a StepsDefinition class create each of the code blocks needed for a rule(step) to be executable in Snakemake. When you have defined each block in your target workflow language task from step 1 , you can go ahead and create, for each of the code blocks required to run a Snakemake rule, a BlockDefinition to handle the rendering of each block. Example: In the Snakemake example, we have created: 1. InputDefinition - Handles the input block, which contains what is required for a rule to be executed. It also handles the params block since the code for extracting the input and params blocks is similar. 2. RunDefinition - Handles the run block which contains the instructions needed for this specific task. 3. OutputDefinition - Handles the output block which is required for the rule to be considered successfully finished. @define class StepDefinition : \"\"\"Represents a Snakemake-renderable step definition in a dewret workflow. Attributes: name (str): The name of the step. run (str): The run block definition for the step. params (List[str]): The parameter definitions for the step. output (list[str]: The output definition for the step. input (List[str]): The input definitions for the step. Methods: from_step(cls, step: Step) -> \"StepDefinition\": Constructs a StepDefinition object from a Step object, extracting step information and components from the step and converting them to Snakemake format. render(self) -> dict[str, MainTypes]: Renders the step definition as a dictionary suitable for use in Snakemake workflows. \"\"\" # You can consider each step as a separate rule. # Each field in this class represents a separate block in the rule definition name : str # name of the rule input : list [ str ] # Input block params : list [ str ] # Params block output : list [ str ] # Output block run : list [ str ] # Run block - where the instructions for the task are @classmethod def from_step ( cls , step : Step ) -> \"StepDefinition\" : \"\"\"Constructs a StepDefinition object from a Step. Args: step (Step): The Step object from which step information and components are extracted. Returns: StepDefinition: A StepDefinition object containing the converted step information and components. \"\"\" input_block = InputDefinition . from_step ( step ) . render () run_block = RunDefinition . from_task ( step . task ) . render () output_block = OutputDefinition . from_step ( step ) . render () return cls ( name = step . name , run = run_block , params = input_block [ \"params\" ], input = input_block [ \"inputs\" ], output = output_block , ) def render ( self ) -> dict [ str , MainTypes ]: \"\"\"Renders the step definition as a dictionary. Returns: dict[str, MainTypes]: A dictionary containing the components of the step definition, for use in Snakemake workflows. \"\"\" return { \"run\" : self . run , \"input\" : self . input , \"params\" : self . params , \"output\" : self . output , } 5. Create the Separate block definitions. In this step, you'll define classes to handle the rendering of each code block required for a rule (step) to be executable in the target workflow language. Each of these classes will encapsulate the logic for converting parts of a workflow step into the target language format. Example: For the Snakemake workflow language, we will define: InputDefinition: Handles the input block and parameter block. RunDefinition: Handles the run block. OutputDefinition: Handles the output block. InputDefinition: The InputDefinition class is responsible for rendering the inputs and parameters required for a Snakemake rule. @define class InputDefinition : \"\"\"Represents input and parameter definitions block for a Snakemake-renderable workflow step. Attributes: inputs (List[str]): A list of input definitions. params (List[str]): A list of parameter definitions. Methods: from_step(cls, step: Step) -> \"InputDefinition\": Constructs an InputDefinition object from a Step object, extracting inputs and parameters and converting them to Snakemake-compatible format. render(self) -> dict[str, str]: Renders the input and parameter definitions as a dictionary for use in Snakemake Input and Params blocks. \"\"\" # As we already mention input and params block have similar generation # So it made sence to encapsulate them into one Definition inputs : list [ str ] params : list [ str ] @classmethod def from_step ( cls , step : Step ) -> \"InputDefinition\" : \"\"\"Constructs an InputDefinition object from a Step. Args: step (Step): The Step object from which input and parameter block definitions are extracted. Returns: InputDefinition: An InputDefinition object. \"\"\" params = [] inputs = [] # The keys represent the names of the arguments of the @tasks in our snakemake_workflow.py. # The params represent the values. for key , param in step . arguments . items (): # We check if the param is a reference. # If it is then it's an input requirement for the rule to run, so we put it in the input block if isinstance ( param , Reference ): ref = ReferenceDefinition . from_reference ( param ) . render () . replace ( \"-\" , \"_\" ) . replace ( \"/out\" , \".output\" ) input = f \" { key } =rules. { ref } .output_file\" inputs . append ( input ) params . append ( input + \",\" ) # If it's not - we put it in the params block for use in the RunDefinition elif isinstance ( param , Raw ): customized = f \" { key } = { to_snakemake_type ( param ) } ,\" params . append ( customized ) # Since the params must be comma separated except the last one - we remove the last comma if params : params [ len ( params ) - 1 ] = params [ len ( params ) - 1 ] . replace ( \",\" , \"\" ) return cls ( inputs = inputs , params = params ) def render ( self ) -> dict [ str , list [ str ]]: \"\"\"Renders the input and parameter definitions as a dictionary. Returns: dict[str, list[MainTypes]]: A dictionary containing the input and parameter definitions, for use in Snakemake Input and Params blocks. \"\"\" return { \"inputs\" : self . inputs , \"params\" : self . params } RunDefinition: The RunDefinition class is responsible for rendering the run block, which contains the actual instructions for the task. @define class RunDefinition : # This is where we handle the execution of the task itself. \"\"\"Represents a Snakemake-renderable run block for a dewret workflow step. Attributes: method_name (str): The name of the method to be executed in the snakefile run block. rel_import (str): The relative import path of the method. args (List[str]): The arguments to be passed to the method. Methods: from_task(cls, task: Task) -> \"RunDefinition\": Constructs a RunDefinition object from a Task object, extracting method information and arguments from the task and converting them to Snakemake-compatible format. render(self) -> list[str]: A list containing the import statement and the method call statement, for use in Snakemake run block. \"\"\" method_name : str rel_import : str args : list [ str ] @classmethod def from_task ( cls , task : Task ) -> \"RunDefinition\" : \"\"\"Constructs a RunDefinition object from a Task. Args: task (Task): The Task object from which method information and arguments are extracted. Returns: RunDefinition: A RunDefinition object containing the converted method information and arguments. \"\"\" # Since we can import our snakemake_workflow.py @tasks we need the relative path relative_path = get_method_rel_path ( task . target ) # If we need to make any customization to the import rel_import = f \" { relative_path } \" args = get_method_args ( task . target ) signature = [ f \" { param_name } =params. { param_name } \" for param_name in args . parameters . keys () ] return cls ( method_name = task . name , rel_import = rel_import , args = signature ) def render ( self ) -> list [ str ]: \"\"\"Renders the run block as a list of strings. Returns: list[str]: A list containing the import statement and the method call statement, for use in Snakemake run block. \"\"\" signature = \", \" . join ( f \" { arg } \" for arg in self . args ) # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump return [ f \"import { self . rel_import } \\n \" , f \" { self . rel_import } . { self . method_name } ( { signature } ) \\n \" , ] OutputDefinition: The OutputDefinition class is responsible for rendering the output block, which specifies the output files or results that indicate the rule has successfully completed. @define class OutputDefinition : \"\"\"Represents the output definition block for a Snakemake-renderable workflow step. Attributes: output_file (str): The output file definition. Methods: from_step(cls, step: Step) -> \"OutputDefinition\": Constructs an OutputDefinition object from a Step object, extracting and converting the output file definition to Snakemake-compatible format. render(self) -> list[str]: Renders the output definition as a list suitable for use in Snakemake Output block. \"\"\" output_file : str @classmethod def from_step ( cls , step : Step ) -> \"OutputDefinition\" : \"\"\"Constructs an OutputDefinition object from a Step. Args: step (Step): The Step object from which the output file definition is extracted. Returns: OutputDefinition: An OutputDefinition object, for use in Snakemake Output block. \"\"\" # Since snakemake commonly communicates using files. # Output file must always be called - `output_file` # Further code could be added to handled if it's a reference in case we want take care of multiple tasks writing to the same output file. output_file = step . arguments [ \"output_file\" ] if isinstance ( output_file , Raw ): args = to_snakemake_type ( output_file ) return cls ( output_file = args ) def render ( self ) -> list [ str ]: \"\"\"Renders the output definition as a list. Returns: list[str]: A list containing the output file definition, for use in a Snakemake Output block. \"\"\" # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump # It adds the new line to the output block return [ f \"output_file= { self . output_file } \" , ] Integrate these block definitions into the StepDefinition class as demonstrated in Step 3 . Each StepDefinition will use these block definitions to render the complete step in the target workflow language. 6. Helper methods. In this step, you'll define helper methods that will assist you in converting workflow components into the target workflow language format. In our case these methods will handle type conversion, extracting method arguments, and computing relative paths. Example: We'll define the following helper methods for our Snakemake renderer: to_snakemake_type(param: Raw) -> str: Converts a raw type to a Snakemake-compatible Python type. get_method_args(func: Lazy) -> inspect.Signature: Retrieves the argument names and types of a lazy-evaluatable function. get_method_rel_path(func: Lazy) -> str: Computes the relative path of the module containing the given function. Type Conversion Helper: # Basic types returned from dewret will look like this \"str|valueOfParam\". # We'll need to convert them. def to_Snakemake_type ( param : Raw ) -> str : typ = str ( param ) if typ . __contains__ ( \"str\" ): return f '\" { typ . replace ( \"str|\" , \"\" ) } \"' elif typ . __contains__ ( \"bool\" ): return typ . replace ( \"bool|\" , \"\" ) elif typ . __contains__ ( \"dict\" ): return typ . replace ( \"dict|\" , \"\" ) elif typ . __contains__ ( \"list\" ): return typ . replace ( \"list|\" , \"\" ) elif typ . __contains__ ( \"float\" ): return typ . replace ( \"float|\" , \"\" ) elif typ . __contains__ ( \"int\" ): return typ . replace ( \"int|\" , \"\" ) else : raise TypeError ( f \"Cannot render complex type ( { typ } )\" ) Argument Extraction Helper: # We need to get the signature of the method. def get_method_args ( func : Lazy ) -> inspect . Signature : args = inspect . signature ( func ) return args Relative Path Computation Helper: # Computes the relative path def get_method_rel_path ( func : Lazy ) -> str : source_file = inspect . getsourcefile ( func ) if source_file : relative_path = os . path . relpath ( source_file , start = os . getcwd ()) module_name = os . path . splitext ( relative_path )[ 0 ] . replace ( os . path . sep , \".\" ) return module_name Imports and custom types required in the SMK example: import os import yaml import inspect import typing from attrs import define from dewret.utils import Raw , BasicType from dewret.workflow import Lazy from dewret.workflow import Reference , Workflow , Step , Task RawType = BasicType | list [ str ] | list [ \"RawType\" ] | dict [ str , \"RawType\" ] To run this example: Import the snakemake renderer into your @tasks file There's an example in snakemake_tasks.py Run it: python snakemake_tasks.py","title":"Renderer Tutorial"},{"location":"docs/renderer_tutorial/#step-by-step-guide-to-writing-a-custom-renderer","text":"","title":"Step-by-Step Guide to Writing a Custom Renderer"},{"location":"docs/renderer_tutorial/#1-understand-the-target-workflow-language","text":"Before writing any code, it is essential to fully understand the target workflow language. This includes syntax, structure, and specific requirements. By breaking down each key dewret.workflow task into smaller components, you can better map your workflow definitions to the target language.","title":"1. Understand the Target Workflow Language"},{"location":"docs/renderer_tutorial/#example","text":"In Snakemake, a workflow task is generally created by: 1. Defining the task. - rule process_data 2. Defining the input required for the rule to run(dependencies). - input: \"data/raw_data.txt\" 3. Defining the output required for the rule to be considered finished. - output: \"data/processed_data.txt\" 4. Defining the actual work that the task will do. - in this case: shell: ... rule process_data: # Example Snakemake rule/task input: \"data/raw_data.txt\" output: output_file = \"data/processed_data.txt\" run: with open ( output.output_file, \"w\" ) as f: f.write ( \"data\" ) return output_file","title":"Example:"},{"location":"docs/renderer_tutorial/#2-create-workflowdefinition","text":"The WorkflowDefinition class is responsible for transforming each step from a constructed dewret workflow into an executable step in the target workflow language (e.g. a Snakemake rule). This class should encapsulate workflow-level information, such as the list of steps to be executed, and any workflow-scope input/ouput. It should also contain a class method that initializes the WorkflowDefinition from an dewret Workflow (such as from_workflow below), and a method that renders the workflow as a Python dict (as in the render method below).","title":"2. Create WorkflowDefinition."},{"location":"docs/renderer_tutorial/#example_1","text":"@define class WorkflowDefinition : steps : list [ StepDefinition ] # Returns a WorkflowDefinition instanace. # Steps contains all of the tasks you want to convert to the target WL tasks. @classmethod def from_workflow ( cls , workflow : Workflow ) -> \"WorkflowDefinition\" : return cls ( steps = [ StepDefinition . from_step ( step ) for step in workflow . steps ]) # Returns each task as a Snakemake executable rule. def render ( self ) -> dict [ str , RawType ]: return { f \"rule { step . name . replace ( \"-\" , \"_\" ) } \" : step . render () for step in self . steps }","title":"Example:"},{"location":"docs/renderer_tutorial/#3-ensuring-our-module-is-recognized-as-a-render-module","text":"To have our custom renderer identified by Dewret as a valid renderer, we need to implement the BaseRenderModule along with one of the two protocols: RawRenderModule or StructuredRenderModule .","title":"3. Ensuring Our Module is Recognized as a Render Module"},{"location":"docs/renderer_tutorial/#implementing-baserendermodule","text":"The BaseRenderModule defines the foundation for a custom renderer. To implement this protocol, we need to define the default_config() method, which provides default configurations for our renderer. def default_config () -> CWLRendererConfiguration : \"\"\"Default configuration for this renderer. This is a hook-like call to give a configuration dict that this renderer will respect, and sets any necessary default values. Returns: a dict with (preferably) raw type structures to enable easy setting from YAML/JSON. \"\"\" return { \"allow_complex_types\" : False , \"factories_as_params\" : False , } After implementing BaseRenderModule , you need to implement either the RawRenderModule or StructuredRenderModule protocol, depending on how you want to handle the workflow rendering.","title":"Implementing BaseRenderModule"},{"location":"docs/renderer_tutorial/#implementing-either-rawrendermodule-or-structuredrendermodule","text":"The StructuredRenderModule is designed for structured workflows that are directly ready to be output in the respective format (e.g., CWL, Snakemake, etc.). The key method to implement is render , which converts a workflow into a structured, serializable format. def render ( self , workflow : WorkflowProtocol , ** kwargs : RenderConfiguration ) -> dict [ str , dict [ str , RawType ]]: \"\"\"Turn a workflow into a serializable structure. Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least. \"\"\" ... In this method: - You receive a workflow and potentially some optional configurations. - You return a dictionary where the __root__ key holds the primary workflow and any additional subworkflows are nested inside the returned structure. If you prefer more flexibility and want the structuring to be handled by the user, you can implement the RawRenderModule protocol. This requires defining the render_raw method, which converts a workflow into raw, flat strings. def render_raw ( self , workflow : WorkflowProtocol , ** kwargs : RenderConfiguration ) -> dict [ str , str ]: \"\"\"Turn a workflow into flat strings. Returns: one or more subworkflows with a `__root__` key representing the outermost workflow, at least. \"\"\" ... In this method: The workflow is rendered as raw, unstructured strings. The user is responsible for handling the structuring of the rendered output.","title":"Implementing either RawRenderModule or StructuredRenderModule"},{"location":"docs/renderer_tutorial/#4-create-a-stepdefinition","text":"Create a StepsDefinition class create each of the code blocks needed for a rule(step) to be executable in Snakemake. When you have defined each block in your target workflow language task from step 1 , you can go ahead and create, for each of the code blocks required to run a Snakemake rule, a BlockDefinition to handle the rendering of each block.","title":"4. Create a StepDefinition."},{"location":"docs/renderer_tutorial/#example_2","text":"In the Snakemake example, we have created: 1. InputDefinition - Handles the input block, which contains what is required for a rule to be executed. It also handles the params block since the code for extracting the input and params blocks is similar. 2. RunDefinition - Handles the run block which contains the instructions needed for this specific task. 3. OutputDefinition - Handles the output block which is required for the rule to be considered successfully finished. @define class StepDefinition : \"\"\"Represents a Snakemake-renderable step definition in a dewret workflow. Attributes: name (str): The name of the step. run (str): The run block definition for the step. params (List[str]): The parameter definitions for the step. output (list[str]: The output definition for the step. input (List[str]): The input definitions for the step. Methods: from_step(cls, step: Step) -> \"StepDefinition\": Constructs a StepDefinition object from a Step object, extracting step information and components from the step and converting them to Snakemake format. render(self) -> dict[str, MainTypes]: Renders the step definition as a dictionary suitable for use in Snakemake workflows. \"\"\" # You can consider each step as a separate rule. # Each field in this class represents a separate block in the rule definition name : str # name of the rule input : list [ str ] # Input block params : list [ str ] # Params block output : list [ str ] # Output block run : list [ str ] # Run block - where the instructions for the task are @classmethod def from_step ( cls , step : Step ) -> \"StepDefinition\" : \"\"\"Constructs a StepDefinition object from a Step. Args: step (Step): The Step object from which step information and components are extracted. Returns: StepDefinition: A StepDefinition object containing the converted step information and components. \"\"\" input_block = InputDefinition . from_step ( step ) . render () run_block = RunDefinition . from_task ( step . task ) . render () output_block = OutputDefinition . from_step ( step ) . render () return cls ( name = step . name , run = run_block , params = input_block [ \"params\" ], input = input_block [ \"inputs\" ], output = output_block , ) def render ( self ) -> dict [ str , MainTypes ]: \"\"\"Renders the step definition as a dictionary. Returns: dict[str, MainTypes]: A dictionary containing the components of the step definition, for use in Snakemake workflows. \"\"\" return { \"run\" : self . run , \"input\" : self . input , \"params\" : self . params , \"output\" : self . output , }","title":"Example:"},{"location":"docs/renderer_tutorial/#5-create-the-separate-block-definitions","text":"In this step, you'll define classes to handle the rendering of each code block required for a rule (step) to be executable in the target workflow language. Each of these classes will encapsulate the logic for converting parts of a workflow step into the target language format.","title":"5. Create the Separate block definitions."},{"location":"docs/renderer_tutorial/#example_3","text":"For the Snakemake workflow language, we will define: InputDefinition: Handles the input block and parameter block. RunDefinition: Handles the run block. OutputDefinition: Handles the output block.","title":"Example:"},{"location":"docs/renderer_tutorial/#inputdefinition","text":"The InputDefinition class is responsible for rendering the inputs and parameters required for a Snakemake rule. @define class InputDefinition : \"\"\"Represents input and parameter definitions block for a Snakemake-renderable workflow step. Attributes: inputs (List[str]): A list of input definitions. params (List[str]): A list of parameter definitions. Methods: from_step(cls, step: Step) -> \"InputDefinition\": Constructs an InputDefinition object from a Step object, extracting inputs and parameters and converting them to Snakemake-compatible format. render(self) -> dict[str, str]: Renders the input and parameter definitions as a dictionary for use in Snakemake Input and Params blocks. \"\"\" # As we already mention input and params block have similar generation # So it made sence to encapsulate them into one Definition inputs : list [ str ] params : list [ str ] @classmethod def from_step ( cls , step : Step ) -> \"InputDefinition\" : \"\"\"Constructs an InputDefinition object from a Step. Args: step (Step): The Step object from which input and parameter block definitions are extracted. Returns: InputDefinition: An InputDefinition object. \"\"\" params = [] inputs = [] # The keys represent the names of the arguments of the @tasks in our snakemake_workflow.py. # The params represent the values. for key , param in step . arguments . items (): # We check if the param is a reference. # If it is then it's an input requirement for the rule to run, so we put it in the input block if isinstance ( param , Reference ): ref = ReferenceDefinition . from_reference ( param ) . render () . replace ( \"-\" , \"_\" ) . replace ( \"/out\" , \".output\" ) input = f \" { key } =rules. { ref } .output_file\" inputs . append ( input ) params . append ( input + \",\" ) # If it's not - we put it in the params block for use in the RunDefinition elif isinstance ( param , Raw ): customized = f \" { key } = { to_snakemake_type ( param ) } ,\" params . append ( customized ) # Since the params must be comma separated except the last one - we remove the last comma if params : params [ len ( params ) - 1 ] = params [ len ( params ) - 1 ] . replace ( \",\" , \"\" ) return cls ( inputs = inputs , params = params ) def render ( self ) -> dict [ str , list [ str ]]: \"\"\"Renders the input and parameter definitions as a dictionary. Returns: dict[str, list[MainTypes]]: A dictionary containing the input and parameter definitions, for use in Snakemake Input and Params blocks. \"\"\" return { \"inputs\" : self . inputs , \"params\" : self . params }","title":"InputDefinition:"},{"location":"docs/renderer_tutorial/#rundefinition","text":"The RunDefinition class is responsible for rendering the run block, which contains the actual instructions for the task. @define class RunDefinition : # This is where we handle the execution of the task itself. \"\"\"Represents a Snakemake-renderable run block for a dewret workflow step. Attributes: method_name (str): The name of the method to be executed in the snakefile run block. rel_import (str): The relative import path of the method. args (List[str]): The arguments to be passed to the method. Methods: from_task(cls, task: Task) -> \"RunDefinition\": Constructs a RunDefinition object from a Task object, extracting method information and arguments from the task and converting them to Snakemake-compatible format. render(self) -> list[str]: A list containing the import statement and the method call statement, for use in Snakemake run block. \"\"\" method_name : str rel_import : str args : list [ str ] @classmethod def from_task ( cls , task : Task ) -> \"RunDefinition\" : \"\"\"Constructs a RunDefinition object from a Task. Args: task (Task): The Task object from which method information and arguments are extracted. Returns: RunDefinition: A RunDefinition object containing the converted method information and arguments. \"\"\" # Since we can import our snakemake_workflow.py @tasks we need the relative path relative_path = get_method_rel_path ( task . target ) # If we need to make any customization to the import rel_import = f \" { relative_path } \" args = get_method_args ( task . target ) signature = [ f \" { param_name } =params. { param_name } \" for param_name in args . parameters . keys () ] return cls ( method_name = task . name , rel_import = rel_import , args = signature ) def render ( self ) -> list [ str ]: \"\"\"Renders the run block as a list of strings. Returns: list[str]: A list containing the import statement and the method call statement, for use in Snakemake run block. \"\"\" signature = \", \" . join ( f \" { arg } \" for arg in self . args ) # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump return [ f \"import { self . rel_import } \\n \" , f \" { self . rel_import } . { self . method_name } ( { signature } ) \\n \" , ]","title":"RunDefinition:"},{"location":"docs/renderer_tutorial/#outputdefinition","text":"The OutputDefinition class is responsible for rendering the output block, which specifies the output files or results that indicate the rule has successfully completed. @define class OutputDefinition : \"\"\"Represents the output definition block for a Snakemake-renderable workflow step. Attributes: output_file (str): The output file definition. Methods: from_step(cls, step: Step) -> \"OutputDefinition\": Constructs an OutputDefinition object from a Step object, extracting and converting the output file definition to Snakemake-compatible format. render(self) -> list[str]: Renders the output definition as a list suitable for use in Snakemake Output block. \"\"\" output_file : str @classmethod def from_step ( cls , step : Step ) -> \"OutputDefinition\" : \"\"\"Constructs an OutputDefinition object from a Step. Args: step (Step): The Step object from which the output file definition is extracted. Returns: OutputDefinition: An OutputDefinition object, for use in Snakemake Output block. \"\"\" # Since snakemake commonly communicates using files. # Output file must always be called - `output_file` # Further code could be added to handled if it's a reference in case we want take care of multiple tasks writing to the same output file. output_file = step . arguments [ \"output_file\" ] if isinstance ( output_file , Raw ): args = to_snakemake_type ( output_file ) return cls ( output_file = args ) def render ( self ) -> list [ str ]: \"\"\"Renders the output definition as a list. Returns: list[str]: A list containing the output file definition, for use in a Snakemake Output block. \"\"\" # The comma after the last element is mandatory for the structure of rule onces it's used in yaml.dump # It adds the new line to the output block return [ f \"output_file= { self . output_file } \" , ] Integrate these block definitions into the StepDefinition class as demonstrated in Step 3 . Each StepDefinition will use these block definitions to render the complete step in the target workflow language.","title":"OutputDefinition:"},{"location":"docs/renderer_tutorial/#6-helper-methods","text":"In this step, you'll define helper methods that will assist you in converting workflow components into the target workflow language format. In our case these methods will handle type conversion, extracting method arguments, and computing relative paths.","title":"6. Helper methods."},{"location":"docs/renderer_tutorial/#example_4","text":"We'll define the following helper methods for our Snakemake renderer: to_snakemake_type(param: Raw) -> str: Converts a raw type to a Snakemake-compatible Python type. get_method_args(func: Lazy) -> inspect.Signature: Retrieves the argument names and types of a lazy-evaluatable function. get_method_rel_path(func: Lazy) -> str: Computes the relative path of the module containing the given function.","title":"Example:"},{"location":"docs/renderer_tutorial/#type-conversion-helper","text":"# Basic types returned from dewret will look like this \"str|valueOfParam\". # We'll need to convert them. def to_Snakemake_type ( param : Raw ) -> str : typ = str ( param ) if typ . __contains__ ( \"str\" ): return f '\" { typ . replace ( \"str|\" , \"\" ) } \"' elif typ . __contains__ ( \"bool\" ): return typ . replace ( \"bool|\" , \"\" ) elif typ . __contains__ ( \"dict\" ): return typ . replace ( \"dict|\" , \"\" ) elif typ . __contains__ ( \"list\" ): return typ . replace ( \"list|\" , \"\" ) elif typ . __contains__ ( \"float\" ): return typ . replace ( \"float|\" , \"\" ) elif typ . __contains__ ( \"int\" ): return typ . replace ( \"int|\" , \"\" ) else : raise TypeError ( f \"Cannot render complex type ( { typ } )\" )","title":"Type Conversion Helper:"},{"location":"docs/renderer_tutorial/#argument-extraction-helper","text":"# We need to get the signature of the method. def get_method_args ( func : Lazy ) -> inspect . Signature : args = inspect . signature ( func ) return args","title":"Argument Extraction Helper:"},{"location":"docs/renderer_tutorial/#relative-path-computation-helper","text":"# Computes the relative path def get_method_rel_path ( func : Lazy ) -> str : source_file = inspect . getsourcefile ( func ) if source_file : relative_path = os . path . relpath ( source_file , start = os . getcwd ()) module_name = os . path . splitext ( relative_path )[ 0 ] . replace ( os . path . sep , \".\" ) return module_name","title":"Relative Path Computation Helper:"},{"location":"docs/renderer_tutorial/#imports-and-custom-types-required-in-the-smk-example","text":"import os import yaml import inspect import typing from attrs import define from dewret.utils import Raw , BasicType from dewret.workflow import Lazy from dewret.workflow import Reference , Workflow , Step , Task RawType = BasicType | list [ str ] | list [ \"RawType\" ] | dict [ str , \"RawType\" ]","title":"Imports and custom types required in the SMK example:"},{"location":"docs/renderer_tutorial/#to-run-this-example","text":"Import the snakemake renderer into your @tasks file There's an example in snakemake_tasks.py Run it: python snakemake_tasks.py","title":"To run this example:"},{"location":"docs/renderers/","text":"Renderers Renderers are a function that takes a task , which can be assumed to have a __workflow__ member of type Workflow , and return a YAML-serializable nested dict structure. CWL The default renderer is for the Common Workflow Language. It implements a very small subset of functionality, and is not yet strictly standards compliant. It assumes that all run names can be interpreted in the context of the workflow module's global scope. Custom ...","title":"Renderers"},{"location":"docs/renderers/#renderers","text":"Renderers are a function that takes a task , which can be assumed to have a __workflow__ member of type Workflow , and return a YAML-serializable nested dict structure.","title":"Renderers"},{"location":"docs/renderers/#cwl","text":"The default renderer is for the Common Workflow Language. It implements a very small subset of functionality, and is not yet strictly standards compliant. It assumes that all run names can be interpreted in the context of the workflow module's global scope.","title":"CWL"},{"location":"docs/renderers/#custom","text":"...","title":"Custom"},{"location":"docs/workflows/","text":"Workflows Description A dewret workflow is composed of one or more steps that may make use of both local and global parameters. Each step is defined by a dewret task that is created by using the @task() decorator, and each task may be used by multiple steps. Setup We can pull in dewret tools to produce CWL with a small number of imports. >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.workflow import param >>> from dewret.renderers.cwl import render Dependencies Specifying step interdependencies is possible by combining lazy-evaluated function calls. The output series of steps is not guaranteed to be in order of execution. Dewret hashes the parameters to identify and unify steps. This lets you do, for example: graph TD A[increment] --> B[double] A[increment] --> C[mod10] B[double] --> D[sum] C[mod10] --> D[sum] In code, this would be: >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @task () ... def increment ( num : int ) -> int : ... \"\"\"Increment an integer.\"\"\" ... return num + 1 >>> >>> @task () ... def double ( num : int ) -> int : ... \"\"\"Double an integer.\"\"\" ... return 2 * num >>> >>> @task () ... def mod10 ( num : int ) -> int : ... \"\"\"Take num mod 10.\"\"\" ... return num % 10 >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... \"\"\"Add two integers.\"\"\" ... return left + right >>> >>> result = sum ( ... left = double ( num = increment ( num = 23 )), ... right = mod10 ( num = increment ( num = 23 )) ... ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : increment - 1 - num : default : 23 label : num type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : double - 1 : in : num : source : increment - 1 / out out : - out run : double increment - 1 : in : num : source : increment - 1 - num out : - out run : increment mod10 - 1 : in : num : source : increment - 1 / out out : - out run : mod10 sum - 1 : in : left : source : double - 1 / out right : source : mod10 - 1 / out out : - out run : sum Notice that the increment tasks appears twice in the CWL workflow definition, being referenced twice in the python code above. This duplication can be avoided by explicitly indicating that the parameters are the same, with the param function. >>> import sys >>> import yaml >>> from dewret.workflow import param >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @task () ... def increment ( num : int ) -> int : ... \"\"\"Increment an integer.\"\"\" ... return num + 1 >>> >>> @task () ... def double ( num : int ) -> int : ... \"\"\"Double an integer.\"\"\" ... return 2 * num >>> >>> @task () ... def mod10 ( num : int ) -> int : ... \"\"\"Take num mod 10.\"\"\" ... return num % 10 >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... \"\"\"Add two integers.\"\"\" ... return left + right >>> >>> num = param ( \"num\" , default = 3 ) >>> result = sum ( ... left = double ( num = increment ( num = num )), ... right = mod10 ( num = increment ( num = num )) ... ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : num : default : 3 label : num type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : double - 1 : in : num : source : increment - 1 / out out : - out run : double increment - 1 : in : num : source : num out : - out run : increment mod10 - 1 : in : num : source : increment - 1 / out out : - out run : mod10 sum - 1 : in : left : source : double - 1 / out right : source : mod10 - 1 / out out : - out run : sum Parameters The tool will spot global variables that you have used when building your tasks, and treat them as parameters. It will try to get the type from the typehint, or the value that you have set it to. This only works for basic types (and dict/lists of those). While global variables are implicit input to the Python function note that : in CWL, they will be rendered as explicit global input to a step as input, they are read-only, and must not be updated For example: >>> import sys >>> import yaml >>> from dewret.workflow import param >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> INPUT_NUM = 3 >>> @task () ... def rotate ( num : int ) -> int : ... \"\"\"Rotate an integer.\"\"\" ... return ( num + INPUT_NUM ) % INPUT_NUM >>> >>> result = rotate ( num = 5 ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : INPUT_NUM : default : 3 label : INPUT_NUM type : int rotate - 1 - num : default : 5 label : num type : int outputs : out : label : out outputSource : rotate - 1 / out type : int steps : rotate - 1 : in : INPUT_NUM : source : INPUT_NUM num : source : rotate - 1 - num out : - out run : rotate Nested tasks When you wish to combine tasks together programmatically, you can use nested tasks. These are run at render time, not execution time. In other words, they do not appear in the final graph, and so must only combine other tasks. For example: graph TD A[rotate] --> B[rotate] B[rotate] --> C[double_rotate] As code: >>> import sys >>> import yaml >>> from dewret.core import set_configuration >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> INPUT_NUM = 3 >>> @task () ... def rotate ( num : int ) -> int : ... \"\"\"Rotate an integer.\"\"\" ... return ( num + INPUT_NUM ) % INPUT_NUM >>> >>> @workflow () ... def double_rotate ( num : int ) -> int : ... \"\"\"Rotate an integer twice.\"\"\" ... return rotate ( num = rotate ( num = num )) >>> >>> with set_configuration ( flatten_all_nested = True ): ... result = double_rotate ( num = 3 ) ... wkflw = construct ( result , simplify_ids = True ) ... cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : INPUT_NUM : default : 3 label : INPUT_NUM type : int num : default : 3 label : num type : int outputs : out : label : out outputSource : rotate - 1 / out type : int steps : rotate - 1 : in : INPUT_NUM : source : INPUT_NUM num : source : rotate - 2 / out out : - out run : rotate rotate - 2 : in : INPUT_NUM : source : INPUT_NUM num : source : num out : - out run : rotate Note that, as with all dewret calculations, only the steps necessary to achieve the ultimate output are included in the final graph. Therefore, nested tasks must return a step execution (task that is being called) that forces any other calculations you wish to happen. In other words, if a task in a nested task does not have an impact on the return value, it will disappear . For example, the following code renders the same workflow as in the previous example: @workflow () def double_rotate ( num : int ) -> int : \"\"\"Rotate an integer twice.\"\"\" unused_var = increment ( num = num ) return rotate ( num = rotate ( num = num )) Step Output Fields Each step, by default, is treated as having a single result. However, we allow a mechanism for specifying multiple fields, using attrs or dataclasses . Where needed, fields can be accessed outside of tasks by dot notation and dewret will map that access to a specific output field in CWL. Note that in the example below, shuffle is still only seen once in the graph: graph TD A[shuffle] --> B[hearts] A[shuffle] --> C[diamonds] B[hearts] --> D[sum] C[diamonds] --> D[sum] As code: >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> red_total = sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> wkflw = construct ( red_total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : shuffle - 1 - max_cards_per_suit : default : 13 label : max_cards_per_suit type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : shuffle - 1 : in : max_cards_per_suit : source : shuffle - 1 - max_cards_per_suit out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 : in : left : source : shuffle - 1 / hearts right : source : shuffle - 1 / diamonds out : - out run : sum Here, we show the same example with dataclasses . >>> import sys >>> import yaml >>> from dataclasses import dataclass >>> from numpy import random >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @dataclass ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> red_total = sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> wkflw = construct ( red_total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : shuffle - 1 - max_cards_per_suit : default : 13 label : max_cards_per_suit type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : shuffle - 1 : in : max_cards_per_suit : source : shuffle - 1 - max_cards_per_suit out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 : in : left : source : shuffle - 1 / hearts right : source : shuffle - 1 / diamonds out : - out run : sum Subworkflow A special form of nested task is available to help divide up more complex workflows: the subworkflow . By wrapping logic in subflows, dewret will produce multiple output workflows that reference each other. >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @workflow () ... def red_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> @workflow () ... def black_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . spades , ... right = shuffle ( max_cards_per_suit = 13 ) . clubs ... ) >>> total = sum ( left = red_total (), right = black_total ()) >>> wkflw = construct ( total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : {} outputs : out : label : out outputSource : sum - 1 / out type : int steps : black_total - 1 : in : {} out : - out run : black_total red_total - 1 : in : {} out : - out run : red_total sum - 1 : in : left : source : red_total - 1 / out right : source : black_total - 1 / out out : - out run : sum As we have used subworkflow to wrap the colour totals, the outer workflow contains references to them only. The subworkflows are now returned by render as a second term. >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def red_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> @workflow () ... def black_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . spades , ... right = shuffle ( max_cards_per_suit = 13 ) . clubs ... ) >>> total = sum ( left = red_total (), right = black_total ()) >>> wkflw = construct ( total , simplify_ids = True ) >>> cwl = render ( wkflw ) >>> yaml . dump ( cwl [ \"red_total-1\" ], sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : {} outputs : out : label : out outputSource : sum - 1 - 1 / out type : int steps : shuffle - 1 - 1 : in : max_cards_per_suit : default : 13 out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 - 1 : in : left : source : shuffle - 1 - 1 / hearts right : source : shuffle - 1 - 1 / diamonds out : - out run : sum Input Factories Sometimes we want to take complex Python input, not just raw types. Not all serialization support this, but the factory function lets us wrap a simple call, usually a constructor, that takes only raw arguments. This can then rendered as either a step or a parameter depending on whether the chosen renderer has the capability. Below is the default output, treating Pack as a task. >>> import sys >>> import yaml >>> from dewret.tasks import workflow , factory , workflow , construct , task >>> from attrs import define >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> Pack = factory ( PackResult ) >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def black_total ( pack : PackResult ) -> int : ... return sum ( ... left = pack . spades , ... right = pack . clubs ... ) >>> pack = Pack ( hearts = 13 , spades = 13 , diamonds = 13 , clubs = 13 ) >>> wkflw = construct ( black_total ( pack = pack ), simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : PackResult - 1 - clubs : default : 13 label : clubs type : int PackResult - 1 - diamonds : default : 13 label : diamonds type : int PackResult - 1 - hearts : default : 13 label : hearts type : int PackResult - 1 - spades : default : 13 label : spades type : int outputs : out : label : out outputSource : black_total - 1 / out type : int steps : PackResult - 1 : in : clubs : source : PackResult - 1 - clubs diamonds : source : PackResult - 1 - diamonds hearts : source : PackResult - 1 - hearts spades : source : PackResult - 1 - spades out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : PackResult black_total - 1 : in : pack : source : PackResult - 1 / out out : - out run : black_total The CWL renderer is also able to treat pack as a parameter, if complex types are allowed. >>> import sys >>> import yaml >>> from dewret.tasks import task , factory , workflow , construct >>> from attrs import define >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> Pack = factory ( PackResult ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def black_total ( pack : PackResult ) -> int : ... return sum ( ... left = pack . spades , ... right = pack . clubs ... ) >>> pack = Pack ( hearts = 13 , spades = 13 , diamonds = 13 , clubs = 13 ) >>> wkflw = construct ( black_total ( pack = pack ), simplify_ids = True ) >>> cwl = render ( wkflw , allow_complex_types = True , factories_as_params = True )[ \"black_total-1\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : pack : label : pack type : record outputs : out : label : out outputSource : sum - 1 - 1 / out type : int steps : sum - 1 - 1 : in : left : source : pack / spades right : source : pack / clubs out : - out run : sum","title":"Workflows"},{"location":"docs/workflows/#workflows","text":"","title":"Workflows"},{"location":"docs/workflows/#description","text":"A dewret workflow is composed of one or more steps that may make use of both local and global parameters. Each step is defined by a dewret task that is created by using the @task() decorator, and each task may be used by multiple steps.","title":"Description"},{"location":"docs/workflows/#setup","text":"We can pull in dewret tools to produce CWL with a small number of imports. >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.workflow import param >>> from dewret.renderers.cwl import render","title":"Setup"},{"location":"docs/workflows/#dependencies","text":"Specifying step interdependencies is possible by combining lazy-evaluated function calls. The output series of steps is not guaranteed to be in order of execution. Dewret hashes the parameters to identify and unify steps. This lets you do, for example: graph TD A[increment] --> B[double] A[increment] --> C[mod10] B[double] --> D[sum] C[mod10] --> D[sum] In code, this would be: >>> import sys >>> import yaml >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @task () ... def increment ( num : int ) -> int : ... \"\"\"Increment an integer.\"\"\" ... return num + 1 >>> >>> @task () ... def double ( num : int ) -> int : ... \"\"\"Double an integer.\"\"\" ... return 2 * num >>> >>> @task () ... def mod10 ( num : int ) -> int : ... \"\"\"Take num mod 10.\"\"\" ... return num % 10 >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... \"\"\"Add two integers.\"\"\" ... return left + right >>> >>> result = sum ( ... left = double ( num = increment ( num = 23 )), ... right = mod10 ( num = increment ( num = 23 )) ... ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : increment - 1 - num : default : 23 label : num type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : double - 1 : in : num : source : increment - 1 / out out : - out run : double increment - 1 : in : num : source : increment - 1 - num out : - out run : increment mod10 - 1 : in : num : source : increment - 1 / out out : - out run : mod10 sum - 1 : in : left : source : double - 1 / out right : source : mod10 - 1 / out out : - out run : sum Notice that the increment tasks appears twice in the CWL workflow definition, being referenced twice in the python code above. This duplication can be avoided by explicitly indicating that the parameters are the same, with the param function. >>> import sys >>> import yaml >>> from dewret.workflow import param >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @task () ... def increment ( num : int ) -> int : ... \"\"\"Increment an integer.\"\"\" ... return num + 1 >>> >>> @task () ... def double ( num : int ) -> int : ... \"\"\"Double an integer.\"\"\" ... return 2 * num >>> >>> @task () ... def mod10 ( num : int ) -> int : ... \"\"\"Take num mod 10.\"\"\" ... return num % 10 >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... \"\"\"Add two integers.\"\"\" ... return left + right >>> >>> num = param ( \"num\" , default = 3 ) >>> result = sum ( ... left = double ( num = increment ( num = num )), ... right = mod10 ( num = increment ( num = num )) ... ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : num : default : 3 label : num type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : double - 1 : in : num : source : increment - 1 / out out : - out run : double increment - 1 : in : num : source : num out : - out run : increment mod10 - 1 : in : num : source : increment - 1 / out out : - out run : mod10 sum - 1 : in : left : source : double - 1 / out right : source : mod10 - 1 / out out : - out run : sum","title":"Dependencies"},{"location":"docs/workflows/#parameters","text":"The tool will spot global variables that you have used when building your tasks, and treat them as parameters. It will try to get the type from the typehint, or the value that you have set it to. This only works for basic types (and dict/lists of those). While global variables are implicit input to the Python function note that : in CWL, they will be rendered as explicit global input to a step as input, they are read-only, and must not be updated For example: >>> import sys >>> import yaml >>> from dewret.workflow import param >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> INPUT_NUM = 3 >>> @task () ... def rotate ( num : int ) -> int : ... \"\"\"Rotate an integer.\"\"\" ... return ( num + INPUT_NUM ) % INPUT_NUM >>> >>> result = rotate ( num = 5 ) >>> wkflw = construct ( result , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : INPUT_NUM : default : 3 label : INPUT_NUM type : int rotate - 1 - num : default : 5 label : num type : int outputs : out : label : out outputSource : rotate - 1 / out type : int steps : rotate - 1 : in : INPUT_NUM : source : INPUT_NUM num : source : rotate - 1 - num out : - out run : rotate","title":"Parameters"},{"location":"docs/workflows/#nested-tasks","text":"When you wish to combine tasks together programmatically, you can use nested tasks. These are run at render time, not execution time. In other words, they do not appear in the final graph, and so must only combine other tasks. For example: graph TD A[rotate] --> B[rotate] B[rotate] --> C[double_rotate] As code: >>> import sys >>> import yaml >>> from dewret.core import set_configuration >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> INPUT_NUM = 3 >>> @task () ... def rotate ( num : int ) -> int : ... \"\"\"Rotate an integer.\"\"\" ... return ( num + INPUT_NUM ) % INPUT_NUM >>> >>> @workflow () ... def double_rotate ( num : int ) -> int : ... \"\"\"Rotate an integer twice.\"\"\" ... return rotate ( num = rotate ( num = num )) >>> >>> with set_configuration ( flatten_all_nested = True ): ... result = double_rotate ( num = 3 ) ... wkflw = construct ( result , simplify_ids = True ) ... cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : INPUT_NUM : default : 3 label : INPUT_NUM type : int num : default : 3 label : num type : int outputs : out : label : out outputSource : rotate - 1 / out type : int steps : rotate - 1 : in : INPUT_NUM : source : INPUT_NUM num : source : rotate - 2 / out out : - out run : rotate rotate - 2 : in : INPUT_NUM : source : INPUT_NUM num : source : num out : - out run : rotate Note that, as with all dewret calculations, only the steps necessary to achieve the ultimate output are included in the final graph. Therefore, nested tasks must return a step execution (task that is being called) that forces any other calculations you wish to happen. In other words, if a task in a nested task does not have an impact on the return value, it will disappear . For example, the following code renders the same workflow as in the previous example: @workflow () def double_rotate ( num : int ) -> int : \"\"\"Rotate an integer twice.\"\"\" unused_var = increment ( num = num ) return rotate ( num = rotate ( num = num ))","title":"Nested tasks"},{"location":"docs/workflows/#step-output-fields","text":"Each step, by default, is treated as having a single result. However, we allow a mechanism for specifying multiple fields, using attrs or dataclasses . Where needed, fields can be accessed outside of tasks by dot notation and dewret will map that access to a specific output field in CWL. Note that in the example below, shuffle is still only seen once in the graph: graph TD A[shuffle] --> B[hearts] A[shuffle] --> C[diamonds] B[hearts] --> D[sum] C[diamonds] --> D[sum] As code: >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> red_total = sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> wkflw = construct ( red_total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : shuffle - 1 - max_cards_per_suit : default : 13 label : max_cards_per_suit type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : shuffle - 1 : in : max_cards_per_suit : source : shuffle - 1 - max_cards_per_suit out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 : in : left : source : shuffle - 1 / hearts right : source : shuffle - 1 / diamonds out : - out run : sum Here, we show the same example with dataclasses . >>> import sys >>> import yaml >>> from dataclasses import dataclass >>> from numpy import random >>> from dewret.tasks import task , construct >>> from dewret.renderers.cwl import render >>> @dataclass ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> red_total = sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> wkflw = construct ( red_total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : shuffle - 1 - max_cards_per_suit : default : 13 label : max_cards_per_suit type : int outputs : out : label : out outputSource : sum - 1 / out type : int steps : shuffle - 1 : in : max_cards_per_suit : source : shuffle - 1 - max_cards_per_suit out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 : in : left : source : shuffle - 1 / hearts right : source : shuffle - 1 / diamonds out : - out run : sum","title":"Step Output Fields"},{"location":"docs/workflows/#subworkflow","text":"A special form of nested task is available to help divide up more complex workflows: the subworkflow . By wrapping logic in subflows, dewret will produce multiple output workflows that reference each other. >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @workflow () ... def red_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> @workflow () ... def black_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . spades , ... right = shuffle ( max_cards_per_suit = 13 ) . clubs ... ) >>> total = sum ( left = red_total (), right = black_total ()) >>> wkflw = construct ( total , simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : {} outputs : out : label : out outputSource : sum - 1 / out type : int steps : black_total - 1 : in : {} out : - out run : black_total red_total - 1 : in : {} out : - out run : red_total sum - 1 : in : left : source : red_total - 1 / out right : source : black_total - 1 / out out : - out run : sum As we have used subworkflow to wrap the colour totals, the outer workflow contains references to them only. The subworkflows are now returned by render as a second term. >>> import sys >>> import yaml >>> from attrs import define >>> from numpy import random >>> from dewret.tasks import task , construct , workflow >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> @task () ... def shuffle ( max_cards_per_suit : int ) -> PackResult : ... \"\"\"Fill a random pile from a card deck, suit by suit.\"\"\" ... return PackResult ( ... hearts = random . randint ( max_cards_per_suit ), ... clubs = random . randint ( max_cards_per_suit ), ... spades = random . randint ( max_cards_per_suit ), ... diamonds = random . randint ( max_cards_per_suit ) ... ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def red_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . hearts , ... right = shuffle ( max_cards_per_suit = 13 ) . diamonds ... ) >>> @workflow () ... def black_total () -> int : ... return sum ( ... left = shuffle ( max_cards_per_suit = 13 ) . spades , ... right = shuffle ( max_cards_per_suit = 13 ) . clubs ... ) >>> total = sum ( left = red_total (), right = black_total ()) >>> wkflw = construct ( total , simplify_ids = True ) >>> cwl = render ( wkflw ) >>> yaml . dump ( cwl [ \"red_total-1\" ], sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : {} outputs : out : label : out outputSource : sum - 1 - 1 / out type : int steps : shuffle - 1 - 1 : in : max_cards_per_suit : default : 13 out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : shuffle sum - 1 - 1 : in : left : source : shuffle - 1 - 1 / hearts right : source : shuffle - 1 - 1 / diamonds out : - out run : sum","title":"Subworkflow"},{"location":"docs/workflows/#input-factories","text":"Sometimes we want to take complex Python input, not just raw types. Not all serialization support this, but the factory function lets us wrap a simple call, usually a constructor, that takes only raw arguments. This can then rendered as either a step or a parameter depending on whether the chosen renderer has the capability. Below is the default output, treating Pack as a task. >>> import sys >>> import yaml >>> from dewret.tasks import workflow , factory , workflow , construct , task >>> from attrs import define >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> Pack = factory ( PackResult ) >>> >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def black_total ( pack : PackResult ) -> int : ... return sum ( ... left = pack . spades , ... right = pack . clubs ... ) >>> pack = Pack ( hearts = 13 , spades = 13 , diamonds = 13 , clubs = 13 ) >>> wkflw = construct ( black_total ( pack = pack ), simplify_ids = True ) >>> cwl = render ( wkflw )[ \"__root__\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : PackResult - 1 - clubs : default : 13 label : clubs type : int PackResult - 1 - diamonds : default : 13 label : diamonds type : int PackResult - 1 - hearts : default : 13 label : hearts type : int PackResult - 1 - spades : default : 13 label : spades type : int outputs : out : label : out outputSource : black_total - 1 / out type : int steps : PackResult - 1 : in : clubs : source : PackResult - 1 - clubs diamonds : source : PackResult - 1 - diamonds hearts : source : PackResult - 1 - hearts spades : source : PackResult - 1 - spades out : clubs : label : clubs type : int diamonds : label : diamonds type : int hearts : label : hearts type : int spades : label : spades type : int run : PackResult black_total - 1 : in : pack : source : PackResult - 1 / out out : - out run : black_total The CWL renderer is also able to treat pack as a parameter, if complex types are allowed. >>> import sys >>> import yaml >>> from dewret.tasks import task , factory , workflow , construct >>> from attrs import define >>> from dewret.renderers.cwl import render >>> @define ... class PackResult : ... hearts : int ... clubs : int ... spades : int ... diamonds : int >>> >>> Pack = factory ( PackResult ) >>> @task () ... def sum ( left : int , right : int ) -> int : ... return left + right >>> >>> @workflow () ... def black_total ( pack : PackResult ) -> int : ... return sum ( ... left = pack . spades , ... right = pack . clubs ... ) >>> pack = Pack ( hearts = 13 , spades = 13 , diamonds = 13 , clubs = 13 ) >>> wkflw = construct ( black_total ( pack = pack ), simplify_ids = True ) >>> cwl = render ( wkflw , allow_complex_types = True , factories_as_params = True )[ \"black_total-1\" ] >>> yaml . dump ( cwl , sys . stdout , indent = 2 ) class : Workflow cwlVersion : 1.2 inputs : pack : label : pack type : record outputs : out : label : out outputSource : sum - 1 - 1 / out type : int steps : sum - 1 - 1 : in : left : source : pack / spades right : source : pack / clubs out : - out run : sum","title":"Input Factories"},{"location":"reference/dewret/","text":"Module dewret dewret: DEclarative Workflow REndering Tool. Dewret allows certain workflows written in a dynamic style to be rendered to a static representation. Sub-modules dewret.annotations dewret.backends dewret.core dewret.render dewret.renderers dewret.tasks dewret.utils dewret.workflow","title":"Index"},{"location":"reference/dewret/#module-dewret","text":"dewret: DEclarative Workflow REndering Tool. Dewret allows certain workflows written in a dynamic style to be rendered to a static representation.","title":"Module dewret"},{"location":"reference/dewret/#sub-modules","text":"dewret.annotations dewret.backends dewret.core dewret.render dewret.renderers dewret.tasks dewret.utils dewret.workflow","title":"Sub-modules"},{"location":"reference/dewret/annotations/","text":"Module dewret.annotations Tooling for managing annotations. Provides FunctionAnalyser , a toolkit that takes a Callable and can interrogate it for annotations, with some intelligent searching beyond the obvious location. Variables AtRender Fixed T Classes FunctionAnalyser class FunctionAnalyser ( fn : Callable [ ... , Any ] ) Convenience class for analysing a function with reduced duplication of effort. Attributes Name Type Description Default _fn None the wrapped callable None _annotations None stored annotations for the function. None Instance variables free_vars Get the free variables for this Callable. globals Get the globals for this Callable. return_type Return type of the callable. Returns: expected type of the return value. Methods argument_has def argument_has ( self , arg : str , annotation : type , exhaustive : bool = False ) -> bool Check if the named argument has the given annotation. Parameters: Name Type Description Default arg None argument to retrieve. None annotation None Annotated to search for. None exhaustive None whether to check the globals and other modules. None get_all_imported_names def get_all_imported_names ( self ) -> dict [ str , tuple [ module , str ]] Find all of the annotations that were imported into this module. get_all_module_names def get_all_module_names ( self ) -> dict [ str , typing . Any ] Find all of the annotations within this module. get_argument_annotation def get_argument_annotation ( self , arg : str , exhaustive : bool = False ) -> Any Retrieve the annotations for this argument. Parameters: Name Type Description Default arg None name of the argument. None exhaustive None True if we should search outside the function itself, into the module globals, and into imported modules. None is_at_construct_arg def is_at_construct_arg ( self , arg : str , exhaustive : bool = False ) -> bool Convience function to check for AtConstruct , wrapping FunctionAnalyser.argument_has . with_new_globals def with_new_globals ( self , new_globals : dict [ str , typing . Any ] ) -> Callable [ ... , Any ] Create a Callable that will run the current Callable with new globals.","title":"Annotations"},{"location":"reference/dewret/annotations/#module-dewretannotations","text":"Tooling for managing annotations. Provides FunctionAnalyser , a toolkit that takes a Callable and can interrogate it for annotations, with some intelligent searching beyond the obvious location.","title":"Module dewret.annotations"},{"location":"reference/dewret/annotations/#variables","text":"AtRender Fixed T","title":"Variables"},{"location":"reference/dewret/annotations/#classes","text":"","title":"Classes"},{"location":"reference/dewret/annotations/#functionanalyser","text":"class FunctionAnalyser ( fn : Callable [ ... , Any ] ) Convenience class for analysing a function with reduced duplication of effort.","title":"FunctionAnalyser"},{"location":"reference/dewret/annotations/#attributes","text":"Name Type Description Default _fn None the wrapped callable None _annotations None stored annotations for the function. None","title":"Attributes"},{"location":"reference/dewret/annotations/#instance-variables","text":"free_vars Get the free variables for this Callable. globals Get the globals for this Callable. return_type Return type of the callable. Returns: expected type of the return value.","title":"Instance variables"},{"location":"reference/dewret/annotations/#methods","text":"","title":"Methods"},{"location":"reference/dewret/annotations/#argument_has","text":"def argument_has ( self , arg : str , annotation : type , exhaustive : bool = False ) -> bool Check if the named argument has the given annotation. Parameters: Name Type Description Default arg None argument to retrieve. None annotation None Annotated to search for. None exhaustive None whether to check the globals and other modules. None","title":"argument_has"},{"location":"reference/dewret/annotations/#get_all_imported_names","text":"def get_all_imported_names ( self ) -> dict [ str , tuple [ module , str ]] Find all of the annotations that were imported into this module.","title":"get_all_imported_names"},{"location":"reference/dewret/annotations/#get_all_module_names","text":"def get_all_module_names ( self ) -> dict [ str , typing . Any ] Find all of the annotations within this module.","title":"get_all_module_names"},{"location":"reference/dewret/annotations/#get_argument_annotation","text":"def get_argument_annotation ( self , arg : str , exhaustive : bool = False ) -> Any Retrieve the annotations for this argument. Parameters: Name Type Description Default arg None name of the argument. None exhaustive None True if we should search outside the function itself, into the module globals, and into imported modules. None","title":"get_argument_annotation"},{"location":"reference/dewret/annotations/#is_at_construct_arg","text":"def is_at_construct_arg ( self , arg : str , exhaustive : bool = False ) -> bool Convience function to check for AtConstruct , wrapping FunctionAnalyser.argument_has .","title":"is_at_construct_arg"},{"location":"reference/dewret/annotations/#with_new_globals","text":"def with_new_globals ( self , new_globals : dict [ str , typing . Any ] ) -> Callable [ ... , Any ] Create a Callable that will run the current Callable with new globals.","title":"with_new_globals"},{"location":"reference/dewret/core/","text":"Module dewret.core Base classes that need to be available everywhere. Mainly tooling around configuration, protocols and superclasses for References and WorkflowComponents, that are concretized elsewhere. Variables BasicType CONFIGURATION ExprType FirmType RawType RenderConfiguration T U Functions default_construct_config def default_construct_config ( ) -> dewret . core . ConstructConfiguration Gets the default construct-time configuration. This is the primary mechanism for configuring dewret internals, so these defaults should be carefully chosen and, if they change, that likely has an impact on backwards compatibility from a SemVer perspective. Returns: configuration dictionary with default construct values. default_renderer_config def default_renderer_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Gets the default renderer configuration. This may be called frequently, but is cached so note that any changes to the wrapped config function will not be reflected during the process. It is a light wrapper for default_config in the supplier renderer module. Returns: the default configuration dict for the chosen renderer. get_configuration def get_configuration ( key : str ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Retrieve the configuration or (silently) return the default. Helps avoid a proliferation of set_configuration calls by not erroring if it has not been called. However, the cost is that the user may accidentally put configuration-affected logic outside a set_configuration call and be surprised that the behaviour is inexplicibly not as expected. Parameters: Name Type Description Default key None configuration key to retrieve. None get_render_configuration def get_render_configuration ( key : str ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Retrieve configuration for the active renderer. Finds the current user-set configuration, defaulting back to the chosen renderer module's declared defaults. Parameters: Name Type Description Default key None configuration key to retrieve. None set_configuration def set_configuration ( ** kwargs : *< class ' dewret . core . ConstructConfigurationTypedDict '> ) -> Iterator [ _contextvars . ContextVar [ dewret . core . GlobalConfiguration ]] Sets the construct-time configuration. This is a context manager, so that a setting can be temporarily overridden and automatically restored. set_render_configuration def set_render_configuration ( kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> Iterator [ _contextvars . ContextVar [ dewret . core . GlobalConfiguration ]] Sets the render-time configuration. This is a context manager, so that a setting can be temporarily overridden and automatically restored. Returns: the yielded global configuration ContextVar. strip_annotations def strip_annotations ( parent_type : type ) -> tuple [ type , tuple [ str ]] Discovers and removes annotations from a parent type. Parameters: Name Type Description Default parent_type None a type, possibly Annotated. None Classes BaseRenderModule class BaseRenderModule ( * args , ** kwargs ) Common routines for all renderer modules. Ancestors (in MRO) typing.Protocol typing.Generic Descendants dewret.core.RawRenderModule dewret.core.StructuredRenderModule Static methods default_config def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict. ConstructConfiguration class ConstructConfiguration ( flatten_all_nested : bool = False , allow_positional_args : bool = False , allow_plain_dict_fields : bool = False , field_separator : str = '/' , field_index_types : str = 'int' , simplify_ids : bool = False ) Basic configuration of the construction process. Holds configuration that may be relevant to construst(...) calls or, realistically, anything prior to rendering. It should hold generic configuration that is renderer-independent. Instance variables allow_plain_dict_fields allow_positional_args field_index_types field_separator flatten_all_nested simplify_ids ConstructConfigurationTypedDict class ConstructConfigurationTypedDict ( / , * args , ** kwargs ) Basic configuration of the construction process. Holds configuration that may be relevant to construst(...) calls or, realistically, anything prior to rendering. It should hold generic configuration that is renderer-independent. THIS MUST BE KEPT IDENTICAL TO ConstructConfiguration. Ancestors (in MRO) builtins.dict Methods clear def clear ( ... ) D.clear() -> None. Remove all items from D. copy def copy ( ... ) D.copy() -> a shallow copy of D fromkeys def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value. get def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default. items def items ( ... ) D.items() -> a set-like object providing a view on D's items keys def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys pop def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError. popitem def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty. setdefault def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default. update def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k] values def values ( ... ) D.values() -> an object providing a view on D's values GlobalConfiguration class GlobalConfiguration ( construct : dewret . core . ConstructConfiguration , render : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) Overall configuration structure. Having a single configuration dict allows us to manage only one ContextVar. Instance variables construct render IterableMixin class IterableMixin ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Functionality for iterating over references to give new references. Ancestors (in MRO) dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Descendants dewret.workflow.IterableParameterReference dewret.workflow.IterableStepReference Class variables default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. IteratedGenerator class IteratedGenerator ( to_wrap : dewret . core . Reference [ ~ U ] ) Sentinel value for capturing that an iteration has occured without performing it. Allows us to lazily evaluate a loop, for instance, in the renderer. This may be relevant if the renderer wishes to postpone iteration to runtime, and simply record it is required, rather than evaluating the iterator. Ancestors (in MRO) typing.Generic Raw class Raw ( value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] ) Value object for any raw types. This is able to hash raw types consistently and provides a single type for validating type-consistency. Attributes Name Type Description Default value None the real value, e.g. a str , int , ... None RawRenderModule class RawRenderModule ( * args , ** kwargs ) Render module that returns raw text. Ancestors (in MRO) dewret.core.BaseRenderModule typing.Protocol typing.Generic Static methods default_config def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict. Methods render_raw def render_raw ( self , workflow : dewret . core . WorkflowProtocol , ** kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> dict [ str , str ] Turn a workflow into flat strings. Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least. Reference class Reference ( * args : Any , typ : type [ ~ U ] | None = None , ** kwargs : Any ) Superclass for all symbolic references to values. Ancestors (in MRO) typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Descendants dewret.core.IterableMixin dewret.workflow.ParameterReference dewret.workflow.StepReference Class variables default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. RenderCall class RenderCall ( * args , ** kwargs ) Callable that will render out workflow(s). Ancestors (in MRO) typing.Protocol typing.Generic StructuredRenderModule class StructuredRenderModule ( * args , ** kwargs ) Render module that returns JSON/YAML-serializable structures. Ancestors (in MRO) dewret.core.BaseRenderModule typing.Protocol typing.Generic Static methods default_config def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict. Methods render def render ( self , workflow : dewret . core . WorkflowProtocol , ** kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> dict [ str , dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]]] Turn a workflow into a serializable structure. Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least. UnevaluatableError class UnevaluatableError ( / , * args , ** kwargs ) Signposts that a user has tried to treat a reference as the real (runtime) value. For example, by comparing to a concrete integer or value, etc. Ancestors (in MRO) builtins.Exception builtins.BaseException Class variables args Methods add_note def add_note ( ... ) Exception.add_note(note) -- add a note to the exception with_traceback def with_traceback ( ... ) Exception.with_traceback(tb) -- set self. traceback to tb and return self. WorkflowComponent class WorkflowComponent ( * args : Any , workflow : dewret . core . WorkflowProtocol , ** kwargs : Any ) Base class for anything directly tied to an individual Workflow . Attributes Name Type Description Default workflow None the Workflow that this is tied to. None Descendants dewret.core.Reference dewret.workflow.BaseStep dewret.workflow.ParameterReference WorkflowProtocol class WorkflowProtocol ( * args , ** kwargs ) Expected structure for a workflow. We do not expect various workflow implementations, but this allows us to define the interface expected by the core classes. Ancestors (in MRO) typing.Protocol typing.Generic Methods remap def remap ( self , name : str ) -> str Perform any name-changing for steps, etc. in the workflow. This enables, for example, simplifying all the IDs to an integer sequence. Returns: remapped name. set_result def set_result ( self , result : sympy . core . basic . Basic | list [ sympy . core . basic . Basic ] | tuple [ sympy . core . basic . Basic ] ) -> None Set the step that should produce a result for the overall workflow. simplify_ids def simplify_ids ( self , infix : list [ str ] | None = None ) -> None Drop the non-human-readable IDs if possible, in favour of integer sequences. Parameters: Name Type Description Default infix None any inherited intermediary identifiers, to allow nesting, or None. None","title":"Core"},{"location":"reference/dewret/core/#module-dewretcore","text":"Base classes that need to be available everywhere. Mainly tooling around configuration, protocols and superclasses for References and WorkflowComponents, that are concretized elsewhere.","title":"Module dewret.core"},{"location":"reference/dewret/core/#variables","text":"BasicType CONFIGURATION ExprType FirmType RawType RenderConfiguration T U","title":"Variables"},{"location":"reference/dewret/core/#functions","text":"","title":"Functions"},{"location":"reference/dewret/core/#default_construct_config","text":"def default_construct_config ( ) -> dewret . core . ConstructConfiguration Gets the default construct-time configuration. This is the primary mechanism for configuring dewret internals, so these defaults should be carefully chosen and, if they change, that likely has an impact on backwards compatibility from a SemVer perspective. Returns: configuration dictionary with default construct values.","title":"default_construct_config"},{"location":"reference/dewret/core/#default_renderer_config","text":"def default_renderer_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Gets the default renderer configuration. This may be called frequently, but is cached so note that any changes to the wrapped config function will not be reflected during the process. It is a light wrapper for default_config in the supplier renderer module. Returns: the default configuration dict for the chosen renderer.","title":"default_renderer_config"},{"location":"reference/dewret/core/#get_configuration","text":"def get_configuration ( key : str ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Retrieve the configuration or (silently) return the default. Helps avoid a proliferation of set_configuration calls by not erroring if it has not been called. However, the cost is that the user may accidentally put configuration-affected logic outside a set_configuration call and be surprised that the behaviour is inexplicibly not as expected. Parameters: Name Type Description Default key None configuration key to retrieve. None","title":"get_configuration"},{"location":"reference/dewret/core/#get_render_configuration","text":"def get_render_configuration ( key : str ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Retrieve configuration for the active renderer. Finds the current user-set configuration, defaulting back to the chosen renderer module's declared defaults. Parameters: Name Type Description Default key None configuration key to retrieve. None","title":"get_render_configuration"},{"location":"reference/dewret/core/#set_configuration","text":"def set_configuration ( ** kwargs : *< class ' dewret . core . ConstructConfigurationTypedDict '> ) -> Iterator [ _contextvars . ContextVar [ dewret . core . GlobalConfiguration ]] Sets the construct-time configuration. This is a context manager, so that a setting can be temporarily overridden and automatically restored.","title":"set_configuration"},{"location":"reference/dewret/core/#set_render_configuration","text":"def set_render_configuration ( kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> Iterator [ _contextvars . ContextVar [ dewret . core . GlobalConfiguration ]] Sets the render-time configuration. This is a context manager, so that a setting can be temporarily overridden and automatically restored. Returns: the yielded global configuration ContextVar.","title":"set_render_configuration"},{"location":"reference/dewret/core/#strip_annotations","text":"def strip_annotations ( parent_type : type ) -> tuple [ type , tuple [ str ]] Discovers and removes annotations from a parent type. Parameters: Name Type Description Default parent_type None a type, possibly Annotated. None","title":"strip_annotations"},{"location":"reference/dewret/core/#classes","text":"","title":"Classes"},{"location":"reference/dewret/core/#baserendermodule","text":"class BaseRenderModule ( * args , ** kwargs ) Common routines for all renderer modules.","title":"BaseRenderModule"},{"location":"reference/dewret/core/#ancestors-in-mro","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#descendants","text":"dewret.core.RawRenderModule dewret.core.StructuredRenderModule","title":"Descendants"},{"location":"reference/dewret/core/#static-methods","text":"","title":"Static methods"},{"location":"reference/dewret/core/#default_config","text":"def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict.","title":"default_config"},{"location":"reference/dewret/core/#constructconfiguration","text":"class ConstructConfiguration ( flatten_all_nested : bool = False , allow_positional_args : bool = False , allow_plain_dict_fields : bool = False , field_separator : str = '/' , field_index_types : str = 'int' , simplify_ids : bool = False ) Basic configuration of the construction process. Holds configuration that may be relevant to construst(...) calls or, realistically, anything prior to rendering. It should hold generic configuration that is renderer-independent.","title":"ConstructConfiguration"},{"location":"reference/dewret/core/#instance-variables","text":"allow_plain_dict_fields allow_positional_args field_index_types field_separator flatten_all_nested simplify_ids","title":"Instance variables"},{"location":"reference/dewret/core/#constructconfigurationtypeddict","text":"class ConstructConfigurationTypedDict ( / , * args , ** kwargs ) Basic configuration of the construction process. Holds configuration that may be relevant to construst(...) calls or, realistically, anything prior to rendering. It should hold generic configuration that is renderer-independent. THIS MUST BE KEPT IDENTICAL TO ConstructConfiguration.","title":"ConstructConfigurationTypedDict"},{"location":"reference/dewret/core/#ancestors-in-mro_1","text":"builtins.dict","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#methods","text":"","title":"Methods"},{"location":"reference/dewret/core/#clear","text":"def clear ( ... ) D.clear() -> None. Remove all items from D.","title":"clear"},{"location":"reference/dewret/core/#copy","text":"def copy ( ... ) D.copy() -> a shallow copy of D","title":"copy"},{"location":"reference/dewret/core/#fromkeys","text":"def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value.","title":"fromkeys"},{"location":"reference/dewret/core/#get","text":"def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default.","title":"get"},{"location":"reference/dewret/core/#items","text":"def items ( ... ) D.items() -> a set-like object providing a view on D's items","title":"items"},{"location":"reference/dewret/core/#keys","text":"def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys","title":"keys"},{"location":"reference/dewret/core/#pop","text":"def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError.","title":"pop"},{"location":"reference/dewret/core/#popitem","text":"def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.","title":"popitem"},{"location":"reference/dewret/core/#setdefault","text":"def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default.","title":"setdefault"},{"location":"reference/dewret/core/#update","text":"def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]","title":"update"},{"location":"reference/dewret/core/#values","text":"def values ( ... ) D.values() -> an object providing a view on D's values","title":"values"},{"location":"reference/dewret/core/#globalconfiguration","text":"class GlobalConfiguration ( construct : dewret . core . ConstructConfiguration , render : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) Overall configuration structure. Having a single configuration dict allows us to manage only one ContextVar.","title":"GlobalConfiguration"},{"location":"reference/dewret/core/#instance-variables_1","text":"construct render","title":"Instance variables"},{"location":"reference/dewret/core/#iterablemixin","text":"class IterableMixin ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Functionality for iterating over references to give new references.","title":"IterableMixin"},{"location":"reference/dewret/core/#ancestors-in-mro_2","text":"dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#descendants_1","text":"dewret.workflow.IterableParameterReference dewret.workflow.IterableStepReference","title":"Descendants"},{"location":"reference/dewret/core/#class-variables","text":"default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/core/#static-methods_1","text":"","title":"Static methods"},{"location":"reference/dewret/core/#class_key","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/core/#fromiter","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/core/#examples","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/core/#instance-variables_2","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/core/#examples_1","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/core/#notes","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/core/#examples_2","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/core/#examples_3","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/core/#methods_1","text":"","title":"Methods"},{"location":"reference/dewret/core/#adjoint","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/core/#apart","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/core/#args_cnc","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/core/#explanation","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/core/#examples_4","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/core/#as_base_exp","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/core/#as_coeff_add","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/core/#as_coeff_mul","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/core/#as_coeff_add_1","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/core/#as_coeff_exponent","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/core/#as_coeff_mul_1","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/core/#as_coefficient","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/core/#examples_5","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/core/#see-also","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/core/#as_coefficients_dict","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/core/#examples_6","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/core/#as_content_primitive","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/core/#examples_7","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/core/#as_dummy","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/core/#examples_8","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/core/#notes_1","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/core/#as_expr","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/core/#examples_9","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/core/#as_independent","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/core/#examples_10","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/core/#see-also_1","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/core/#as_leading_term","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/core/#examples_11","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/core/#as_numer_denom","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/core/#see-also_2","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/core/#as_ordered_factors","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/core/#as_ordered_terms","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/core/#examples_12","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/core/#as_poly","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/core/#explanation_1","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/core/#as_powers_dict","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/core/#see-also_3","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/core/#as_real_imag","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/core/#as_set","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/core/#examples_13","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/core/#as_terms","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/core/#aseries","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/core/#parameters","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/core/#examples_14","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/core/#returns","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/core/#notes_2","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/core/#references","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/core/#see-also_4","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/core/#atoms","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/core/#examples_15","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/core/#cancel","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/core/#coeff","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/core/#explanation_2","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/core/#examples_16","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/core/#see-also_5","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/core/#collect","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/core/#combsimp","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/core/#compare","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/core/#examples_17","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/core/#compute_leading_term","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/core/#conjugate","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/core/#copy_1","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/core/#could_extract_minus_sign","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/core/#examples_18","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/core/#count","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/core/#count_ops","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/core/#diff","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/core/#dir","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/core/#doit","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/core/#dummy_eq","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/core/#examples_19","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/core/#equals","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/core/#explanation_3","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/core/#evalf","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/core/#parameters_1","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/core/#notes_3","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/core/#expand","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/core/#extract_additively","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/core/#examples_20","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/core/#see-also_6","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/core/#extract_branch_factor","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/core/#extract_multiplicatively","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/core/#examples_21","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/core/#factor","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/core/#find","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/core/#fourier_series","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/core/#fps","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/core/#gammasimp","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/core/#geto","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/core/#getn","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/core/#explanation_4","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/core/#examples_22","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/core/#has","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/core/#examples_23","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/core/#has_free","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/core/#examples_24","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/core/#has_xfree","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/core/#examples_25","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/core/#integrate","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/core/#invert","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/core/#see-also_7","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/core/#is_algebraic_expr","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/core/#examples_26","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/core/#see-also_8","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/core/#references_1","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/core/#is_constant","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/core/#explanation_5","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/core/#examples_27","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/core/#is_hypergeometric","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/core/#is_meromorphic","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/core/#examples_28","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/core/#is_polynomial","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/core/#examples_29","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/core/#is_rational_function","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/core/#examples_30","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/core/#is_same","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/core/#examples_31","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/core/#leadterm","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/core/#examples_32","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/core/#limit","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/core/#lseries","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/core/#match","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/core/#examples_33","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/core/#matches","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/core/#examples_34","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/core/#n","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/core/#parameters_2","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/core/#notes_4","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/core/#normal","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/core/#see-also_9","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/core/#nseries","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/core/#examples_35","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/core/#nsimplify","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/core/#powsimp","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/core/#primitive","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/core/#examples_36","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/core/#radsimp","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/core/#ratsimp","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/core/#rcall","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/core/#refine","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/core/#removeo","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/core/#replace","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/core/#examples_37","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/core/#see-also_10","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/core/#rewrite","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/core/#parameters_3","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/core/#examples_38","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/core/#round","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/core/#examples_39","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/core/#notes_5","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/core/#separate","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/core/#series","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/core/#parameters_4","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/core/#examples_40","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/core/#returns_1","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/core/#raises","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/core/#simplify","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/core/#sort_key","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/core/#examples_41","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/core/#subs","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/core/#examples_42","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/core/#see-also_11","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/core/#taylor_term","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/core/#to_nnf","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/core/#together","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/core/#transpose","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/core/#trigsimp","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/core/#xreplace","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/core/#parameters_5","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/core/#returns_2","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/core/#examples_43","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/core/#see-also_12","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/core/#iteratedgenerator","text":"class IteratedGenerator ( to_wrap : dewret . core . Reference [ ~ U ] ) Sentinel value for capturing that an iteration has occured without performing it. Allows us to lazily evaluate a loop, for instance, in the renderer. This may be relevant if the renderer wishes to postpone iteration to runtime, and simply record it is required, rather than evaluating the iterator.","title":"IteratedGenerator"},{"location":"reference/dewret/core/#ancestors-in-mro_3","text":"typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#raw","text":"class Raw ( value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] ) Value object for any raw types. This is able to hash raw types consistently and provides a single type for validating type-consistency.","title":"Raw"},{"location":"reference/dewret/core/#attributes","text":"Name Type Description Default value None the real value, e.g. a str , int , ... None","title":"Attributes"},{"location":"reference/dewret/core/#rawrendermodule","text":"class RawRenderModule ( * args , ** kwargs ) Render module that returns raw text.","title":"RawRenderModule"},{"location":"reference/dewret/core/#ancestors-in-mro_4","text":"dewret.core.BaseRenderModule typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#static-methods_2","text":"","title":"Static methods"},{"location":"reference/dewret/core/#default_config_1","text":"def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict.","title":"default_config"},{"location":"reference/dewret/core/#methods_2","text":"","title":"Methods"},{"location":"reference/dewret/core/#render_raw","text":"def render_raw ( self , workflow : dewret . core . WorkflowProtocol , ** kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> dict [ str , str ] Turn a workflow into flat strings. Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least.","title":"render_raw"},{"location":"reference/dewret/core/#reference","text":"class Reference ( * args : Any , typ : type [ ~ U ] | None = None , ** kwargs : Any ) Superclass for all symbolic references to values.","title":"Reference"},{"location":"reference/dewret/core/#ancestors-in-mro_5","text":"typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#descendants_2","text":"dewret.core.IterableMixin dewret.workflow.ParameterReference dewret.workflow.StepReference","title":"Descendants"},{"location":"reference/dewret/core/#class-variables_1","text":"default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/core/#static-methods_3","text":"","title":"Static methods"},{"location":"reference/dewret/core/#class_key_1","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/core/#fromiter_1","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/core/#examples_44","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/core/#instance-variables_3","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/core/#examples_45","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/core/#notes_6","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/core/#examples_46","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/core/#examples_47","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/core/#methods_3","text":"","title":"Methods"},{"location":"reference/dewret/core/#adjoint_1","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/core/#apart_1","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/core/#args_cnc_1","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/core/#explanation_6","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/core/#examples_48","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/core/#as_base_exp_1","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/core/#as_coeff_add_2","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/core/#as_coeff_mul_2","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/core/#as_coeff_add_3","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/core/#as_coeff_exponent_1","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/core/#as_coeff_mul_3","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/core/#as_coefficient_1","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/core/#examples_49","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/core/#see-also_13","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/core/#as_coefficients_dict_1","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/core/#examples_50","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/core/#as_content_primitive_1","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/core/#examples_51","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/core/#as_dummy_1","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/core/#examples_52","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/core/#notes_7","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/core/#as_expr_1","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/core/#examples_53","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/core/#as_independent_1","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/core/#examples_54","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/core/#see-also_14","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/core/#as_leading_term_1","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/core/#examples_55","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/core/#as_numer_denom_1","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/core/#see-also_15","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/core/#as_ordered_factors_1","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/core/#as_ordered_terms_1","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/core/#examples_56","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/core/#as_poly_1","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/core/#explanation_7","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/core/#as_powers_dict_1","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/core/#see-also_16","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/core/#as_real_imag_1","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/core/#as_set_1","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/core/#examples_57","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/core/#as_terms_1","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/core/#aseries_1","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/core/#parameters_6","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/core/#examples_58","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/core/#returns_3","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/core/#notes_8","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/core/#references_2","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/core/#see-also_17","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/core/#atoms_1","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/core/#examples_59","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/core/#cancel_1","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/core/#coeff_1","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/core/#explanation_8","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/core/#examples_60","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/core/#see-also_18","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/core/#collect_1","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/core/#combsimp_1","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/core/#compare_1","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/core/#examples_61","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/core/#compute_leading_term_1","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/core/#conjugate_1","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/core/#copy_2","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/core/#could_extract_minus_sign_1","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/core/#examples_62","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/core/#count_1","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/core/#count_ops_1","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/core/#diff_1","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/core/#dir_1","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/core/#doit_1","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/core/#dummy_eq_1","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/core/#examples_63","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/core/#equals_1","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/core/#explanation_9","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/core/#evalf_1","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/core/#parameters_7","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/core/#notes_9","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/core/#expand_1","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/core/#extract_additively_1","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/core/#examples_64","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/core/#see-also_19","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/core/#extract_branch_factor_1","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/core/#extract_multiplicatively_1","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/core/#examples_65","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/core/#factor_1","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/core/#find_1","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/core/#fourier_series_1","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/core/#fps_1","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/core/#gammasimp_1","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/core/#geto_1","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/core/#getn_1","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/core/#explanation_10","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/core/#examples_66","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/core/#has_1","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/core/#examples_67","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/core/#has_free_1","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/core/#examples_68","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/core/#has_xfree_1","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/core/#examples_69","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/core/#integrate_1","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/core/#invert_1","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/core/#see-also_20","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/core/#is_algebraic_expr_1","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/core/#examples_70","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/core/#see-also_21","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/core/#references_3","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/core/#is_constant_1","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/core/#explanation_11","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/core/#examples_71","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/core/#is_hypergeometric_1","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/core/#is_meromorphic_1","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/core/#examples_72","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/core/#is_polynomial_1","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/core/#examples_73","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/core/#is_rational_function_1","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/core/#examples_74","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/core/#is_same_1","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/core/#examples_75","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/core/#leadterm_1","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/core/#examples_76","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/core/#limit_1","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/core/#lseries_1","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/core/#match_1","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/core/#examples_77","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/core/#matches_1","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/core/#examples_78","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/core/#n_1","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/core/#parameters_8","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/core/#notes_10","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/core/#normal_1","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/core/#see-also_22","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/core/#nseries_1","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/core/#examples_79","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/core/#nsimplify_1","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/core/#powsimp_1","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/core/#primitive_1","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/core/#examples_80","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/core/#radsimp_1","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/core/#ratsimp_1","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/core/#rcall_1","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/core/#refine_1","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/core/#removeo_1","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/core/#replace_1","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/core/#examples_81","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/core/#see-also_23","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/core/#rewrite_1","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/core/#parameters_9","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/core/#examples_82","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/core/#round_1","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/core/#examples_83","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/core/#notes_11","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/core/#separate_1","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/core/#series_1","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/core/#parameters_10","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/core/#examples_84","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/core/#returns_4","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/core/#raises_1","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/core/#simplify_1","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/core/#sort_key_1","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/core/#examples_85","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/core/#subs_1","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/core/#examples_86","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/core/#see-also_24","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/core/#taylor_term_1","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/core/#to_nnf_1","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/core/#together_1","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/core/#transpose_1","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/core/#trigsimp_1","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/core/#xreplace_1","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/core/#parameters_11","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/core/#returns_5","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/core/#examples_87","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/core/#see-also_25","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/core/#rendercall","text":"class RenderCall ( * args , ** kwargs ) Callable that will render out workflow(s).","title":"RenderCall"},{"location":"reference/dewret/core/#ancestors-in-mro_6","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#structuredrendermodule","text":"class StructuredRenderModule ( * args , ** kwargs ) Render module that returns JSON/YAML-serializable structures.","title":"StructuredRenderModule"},{"location":"reference/dewret/core/#ancestors-in-mro_7","text":"dewret.core.BaseRenderModule typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#static-methods_4","text":"","title":"Static methods"},{"location":"reference/dewret/core/#default_config_2","text":"def default_config ( ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Retrieve default settings. These will not change during execution, but can be overridden by dewret.core.set_render_configuration . Returns: a static, serializable dict.","title":"default_config"},{"location":"reference/dewret/core/#methods_4","text":"","title":"Methods"},{"location":"reference/dewret/core/#render","text":"def render ( self , workflow : dewret . core . WorkflowProtocol , ** kwargs : dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] ) -> dict [ str , dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]]] Turn a workflow into a serializable structure. Returns: one or more subworkflows with a __root__ key representing the outermost workflow, at least.","title":"render"},{"location":"reference/dewret/core/#unevaluatableerror","text":"class UnevaluatableError ( / , * args , ** kwargs ) Signposts that a user has tried to treat a reference as the real (runtime) value. For example, by comparing to a concrete integer or value, etc.","title":"UnevaluatableError"},{"location":"reference/dewret/core/#ancestors-in-mro_8","text":"builtins.Exception builtins.BaseException","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#class-variables_2","text":"args","title":"Class variables"},{"location":"reference/dewret/core/#methods_5","text":"","title":"Methods"},{"location":"reference/dewret/core/#add_note","text":"def add_note ( ... ) Exception.add_note(note) -- add a note to the exception","title":"add_note"},{"location":"reference/dewret/core/#with_traceback","text":"def with_traceback ( ... ) Exception.with_traceback(tb) -- set self. traceback to tb and return self.","title":"with_traceback"},{"location":"reference/dewret/core/#workflowcomponent","text":"class WorkflowComponent ( * args : Any , workflow : dewret . core . WorkflowProtocol , ** kwargs : Any ) Base class for anything directly tied to an individual Workflow .","title":"WorkflowComponent"},{"location":"reference/dewret/core/#attributes_1","text":"Name Type Description Default workflow None the Workflow that this is tied to. None","title":"Attributes"},{"location":"reference/dewret/core/#descendants_3","text":"dewret.core.Reference dewret.workflow.BaseStep dewret.workflow.ParameterReference","title":"Descendants"},{"location":"reference/dewret/core/#workflowprotocol","text":"class WorkflowProtocol ( * args , ** kwargs ) Expected structure for a workflow. We do not expect various workflow implementations, but this allows us to define the interface expected by the core classes.","title":"WorkflowProtocol"},{"location":"reference/dewret/core/#ancestors-in-mro_9","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/core/#methods_6","text":"","title":"Methods"},{"location":"reference/dewret/core/#remap","text":"def remap ( self , name : str ) -> str Perform any name-changing for steps, etc. in the workflow. This enables, for example, simplifying all the IDs to an integer sequence. Returns: remapped name.","title":"remap"},{"location":"reference/dewret/core/#set_result","text":"def set_result ( self , result : sympy . core . basic . Basic | list [ sympy . core . basic . Basic ] | tuple [ sympy . core . basic . Basic ] ) -> None Set the step that should produce a result for the overall workflow.","title":"set_result"},{"location":"reference/dewret/core/#simplify_ids","text":"def simplify_ids ( self , infix : list [ str ] | None = None ) -> None Drop the non-human-readable IDs if possible, in favour of integer sequences. Parameters: Name Type Description Default infix None any inherited intermediary identifiers, to allow nesting, or None. None","title":"simplify_ids"},{"location":"reference/dewret/render/","text":"Module dewret.render Utilities for building renderers. Provides the routines for calling varied renderers in a standard way, and for renderers to reuse to build up their own functionality. Variables T Functions base_render def base_render ( workflow : dewret . workflow . Workflow , build_cb : Callable [[ dewret . workflow . Workflow ], ~ T ] ) -> dict [ str , ~ T ] Render to a dict-like structure. Parameters: Name Type Description Default workflow None workflow to evaluate result. None build_cb None a callback to call for each workflow found. None Returns: Type Description None Reduced form as a native Python dict structure for serialization. get_render_method def get_render_method ( renderer : pathlib . Path | dewret . core . RawRenderModule | dewret . core . StructuredRenderModule , pretty : bool = False ) -> dewret . core . RenderCall Create a ready-made callable to render the workflow that is appropriate for the renderer module. Parameters: Name Type Description Default renderer None a module or path to a module. None pretty None whether the renderer should attempt to YAML-format the output (if relevant). None structured_to_raw def structured_to_raw ( rendered : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ], pretty : bool = False ) -> str Serialize a serializable structure to a string. Parameters: Name Type Description Default rendered None a possibly-nested, static basic Python structure. None pretty None whether to attempt YAML dumping with an indent of 2. None write_rendered_output def write_rendered_output ( rendered : dict [ str , str ] | dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]], output : str , opener : Callable [[ str , str ], ContextManager [ IO [ Any ]]] ) -> None Utility function to handle writing rendered output to file or stdout.","title":"Render"},{"location":"reference/dewret/render/#module-dewretrender","text":"Utilities for building renderers. Provides the routines for calling varied renderers in a standard way, and for renderers to reuse to build up their own functionality.","title":"Module dewret.render"},{"location":"reference/dewret/render/#variables","text":"T","title":"Variables"},{"location":"reference/dewret/render/#functions","text":"","title":"Functions"},{"location":"reference/dewret/render/#base_render","text":"def base_render ( workflow : dewret . workflow . Workflow , build_cb : Callable [[ dewret . workflow . Workflow ], ~ T ] ) -> dict [ str , ~ T ] Render to a dict-like structure. Parameters: Name Type Description Default workflow None workflow to evaluate result. None build_cb None a callback to call for each workflow found. None Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"base_render"},{"location":"reference/dewret/render/#get_render_method","text":"def get_render_method ( renderer : pathlib . Path | dewret . core . RawRenderModule | dewret . core . StructuredRenderModule , pretty : bool = False ) -> dewret . core . RenderCall Create a ready-made callable to render the workflow that is appropriate for the renderer module. Parameters: Name Type Description Default renderer None a module or path to a module. None pretty None whether the renderer should attempt to YAML-format the output (if relevant). None","title":"get_render_method"},{"location":"reference/dewret/render/#structured_to_raw","text":"def structured_to_raw ( rendered : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ], pretty : bool = False ) -> str Serialize a serializable structure to a string. Parameters: Name Type Description Default rendered None a possibly-nested, static basic Python structure. None pretty None whether to attempt YAML dumping with an indent of 2. None","title":"structured_to_raw"},{"location":"reference/dewret/render/#write_rendered_output","text":"def write_rendered_output ( rendered : dict [ str , str ] | dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]], output : str , opener : Callable [[ str , str ], ContextManager [ IO [ Any ]]] ) -> None Utility function to handle writing rendered output to file or stdout.","title":"write_rendered_output"},{"location":"reference/dewret/tasks/","text":"Module dewret.tasks Abstraction layer for task operations. Access dask, or other, backends consistently using this module. It provides decorators and execution calls that manage tasks. Note that the task decorator should be called with no arguments, and will return the appropriate decorator for the current backend. Typical usage example: >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 Variables DEFAULT_BACKEND Param RetType construct An alias pointing to an instance of the TaskManager class. Used for constructing a set of tasks into a dewret workflow instance. Functions ensure_lazy def ensure_lazy ( task : Any ) -> dewret . workflow . Lazy | None Evaluate a single task for a known workflow. As we mask our lazy-evaluable functions to appear as their original types to the type system (see dewret.tasks.task ), we must cast them back, to allow the type-checker to comb the remainder of the code. Parameters: Name Type Description Default task None the suspected task to check. None Returns: Type Description None Original task, cast to a Lazy, or None. evaluate def evaluate ( task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], __workflow__ : dewret . workflow . Workflow , thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Evaluate a single task for a known workflow. Parameters: Name Type Description Default task None the task to evaluate. None workflow None workflow within which this exists. None thread_pool None existing pool of threads to run this in, or None. None **kwargs None any arguments to pass to the task. None factory def factory ( fn : collections . abc . Callable [ ... , ~ RetType ] ) -> collections . abc . Callable [ ... , ~ RetType ] Create a factory, that can be treated as complex input to a workflow. Parameters: Name Type Description Default fn None a callable to create the entity. None in_nested_task def in_nested_task ( ) -> Generator [ NoneType , NoneType , NoneType ] Informs the builder that we are within a nested task. This is only really relevant in the subworkflow context. TODO: check impact of ContextVar being thread-sensitive on build. is_in_nested_task def is_in_nested_task ( ) -> bool Check if we are within a nested task. Used, for example, to see if discovered parameters should be treated as \"local\" (i.e. should take a default to the step) or global (i.e. should be turned into a workflow parameter) if we are inside or outside a subworkflow, respectively. lazy def lazy ( ) -> collections . abc . Callable [[ collections . abc . Callable [ ... , typing . Any ]], dewret . workflow . Lazy ] Get the lazy decorator for this backend. Returns: Type Description None Real decorator for this backend. set_backend def set_backend ( backend : dewret . tasks . Backend ) -> None Choose a backend. Will raise an error if a backend is already chosen. Parameters: Name Type Description Default backend None chosen backend to use from here-on in. None task def task ( nested : bool = False , flatten_nested : bool = True , is_factory : bool = False ) -> collections . abc . Callable [[ collections . abc . Callable [ ~ Param , ~ RetType ]], collections . abc . Callable [ ~ Param , ~ RetType ]] Decorator factory abstracting backend's own task decorator. For example: >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 If the backend is dask (the default), it is will evaluate this as a dask.delayed . Note that, with any backend, dewret will hijack the decorator to record the attempted evalution rather than actually evaluating the lazy function. Nonetheless, this hijacking will still be executed with the backend's lazy executor, so dask.delayed will still be called, for example, in the dask case. Parameters: Name Type Description Default nested None whether this should be executed to find other tasks. None flatten_nested None (only relevant to nested tasks) should this nested task be considered a distinct subworkflow, or is it just organizational for the outer workflow. None is_factory None whether this task should be marked as a 'factory', rather than a normal step. None Returns: Type Description None Decorator for the current backend to mark lazy-executable tasks. Raises: Type Description TypeError if arguments are missing or incorrect, in line with usual Python behaviour. unwrap def unwrap ( task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. Ideally, we could use the __wrapped__ property but not all workflow engines support this, and most importantly, dask has only done so as of 2024.03. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function. workflow def workflow ( ) -> collections . abc . Callable [[ collections . abc . Callable [ ~ Param , ~ RetType ]], collections . abc . Callable [ ~ Param , ~ RetType ]] Shortcut for marking a task as nested. A nested task is one which calls other tasks and does not do anything else important. It will not actually get called at runtime, but should map entirely into the graph. As such, arithmetic operations on results, etc. will cause errors at render-time. Combining tasks is acceptable, and intended. The effect of the nested task will be considered equivalent to whatever reaching whatever step reference is returned at the end. >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 >>> @workflow () ... def double_increment ( num : int ) -> int : ... return increment ( increment ( num = num )) Returns: Type Description None Task that runs at render, not execution, time. Classes Backend class Backend ( * args , ** kwds ) Stringy enum representing available backends. Ancestors (in MRO) enum.Enum Class variables DASK name value TaskException class TaskException ( task : dewret . workflow . Task | collections . abc . Callable [ ... , typing . Any ], dec_tb : traceback | None , tb : traceback | None , message : str , * args : Any , ** kwargs : Any ) Exception tied to a specific task. Primarily aimed at parsing issues, but this will ensure that a message is shown with useful debug information for the workflow writer. Ancestors (in MRO) builtins.Exception builtins.BaseException Class variables args Methods add_note def add_note ( ... ) Exception.add_note(note) -- add a note to the exception with_traceback def with_traceback ( ... ) Exception.with_traceback(tb) -- set self. traceback to tb and return self. TaskManager class TaskManager ( / , * args , ** kwargs ) Overarching backend-agnostic task manager. Gatekeeps the specific backend implementation. This can be instantiated without choosing a backend, but the first call to any of its methods will concretize that choice - either as the default, or the backend set via TaskManager.set_backend . It cannot be changed after this point. Methods backend def backend ( ... ) Import backend module. Cached property to load the backend module, if it has not been already. Returns: Type Description None Backend module for the specific choice of backend. ensure_lazy def ensure_lazy ( self , task : Any ) -> dewret . workflow . Lazy | None Evaluate a single task for a known workflow. As we mask our lazy-evaluable functions to appear as their original types to the type system (see dewret.tasks.task ), we must cast them back, to allow the type-checker to comb the remainder of the code. Parameters: Name Type Description Default task None the suspected task to check. None Returns: Type Description None Original task, cast to a Lazy, or None. evaluate def evaluate ( self , task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], __workflow__ : dewret . workflow . Workflow , thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Evaluate a single task for a known workflow. Parameters: Name Type Description Default task None the task to evaluate. None workflow None workflow within which this exists. None thread_pool None existing pool of threads to run this in, or None. None **kwargs None any arguments to pass to the task. None make_lazy def make_lazy ( self ) -> collections . abc . Callable [[ collections . abc . Callable [ ... , typing . Any ]], dewret . workflow . Lazy ] Get the lazy decorator for this backend. Returns: Type Description None Real decorator for this backend. set_backend def set_backend ( self , backend : dewret . tasks . Backend ) -> dewret . tasks . Backend Choose a backend. Sets the backend, provided it has not already been loaded. Parameters: Name Type Description Default backend None chosen backend, to override the default. None Returns: Type Description None Backend that was set. Raises: Type Description RuntimeError when a backend has already been loaded. unwrap def unwrap ( self , task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. Ideally, we could use the __wrapped__ property but not all workflow engines support this, and most importantly, dask has only done so as of 2024.03. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function.","title":"Tasks"},{"location":"reference/dewret/tasks/#module-dewrettasks","text":"Abstraction layer for task operations. Access dask, or other, backends consistently using this module. It provides decorators and execution calls that manage tasks. Note that the task decorator should be called with no arguments, and will return the appropriate decorator for the current backend. Typical usage example: >>> @task () ... def increment ( num : int ) -> int : ... return num + 1","title":"Module dewret.tasks"},{"location":"reference/dewret/tasks/#variables","text":"DEFAULT_BACKEND Param RetType construct An alias pointing to an instance of the TaskManager class. Used for constructing a set of tasks into a dewret workflow instance.","title":"Variables"},{"location":"reference/dewret/tasks/#functions","text":"","title":"Functions"},{"location":"reference/dewret/tasks/#ensure_lazy","text":"def ensure_lazy ( task : Any ) -> dewret . workflow . Lazy | None Evaluate a single task for a known workflow. As we mask our lazy-evaluable functions to appear as their original types to the type system (see dewret.tasks.task ), we must cast them back, to allow the type-checker to comb the remainder of the code. Parameters: Name Type Description Default task None the suspected task to check. None Returns: Type Description None Original task, cast to a Lazy, or None.","title":"ensure_lazy"},{"location":"reference/dewret/tasks/#evaluate","text":"def evaluate ( task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], __workflow__ : dewret . workflow . Workflow , thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Evaluate a single task for a known workflow. Parameters: Name Type Description Default task None the task to evaluate. None workflow None workflow within which this exists. None thread_pool None existing pool of threads to run this in, or None. None **kwargs None any arguments to pass to the task. None","title":"evaluate"},{"location":"reference/dewret/tasks/#factory","text":"def factory ( fn : collections . abc . Callable [ ... , ~ RetType ] ) -> collections . abc . Callable [ ... , ~ RetType ] Create a factory, that can be treated as complex input to a workflow. Parameters: Name Type Description Default fn None a callable to create the entity. None","title":"factory"},{"location":"reference/dewret/tasks/#in_nested_task","text":"def in_nested_task ( ) -> Generator [ NoneType , NoneType , NoneType ] Informs the builder that we are within a nested task. This is only really relevant in the subworkflow context. TODO: check impact of ContextVar being thread-sensitive on build.","title":"in_nested_task"},{"location":"reference/dewret/tasks/#is_in_nested_task","text":"def is_in_nested_task ( ) -> bool Check if we are within a nested task. Used, for example, to see if discovered parameters should be treated as \"local\" (i.e. should take a default to the step) or global (i.e. should be turned into a workflow parameter) if we are inside or outside a subworkflow, respectively.","title":"is_in_nested_task"},{"location":"reference/dewret/tasks/#lazy","text":"def lazy ( ) -> collections . abc . Callable [[ collections . abc . Callable [ ... , typing . Any ]], dewret . workflow . Lazy ] Get the lazy decorator for this backend. Returns: Type Description None Real decorator for this backend.","title":"lazy"},{"location":"reference/dewret/tasks/#set_backend","text":"def set_backend ( backend : dewret . tasks . Backend ) -> None Choose a backend. Will raise an error if a backend is already chosen. Parameters: Name Type Description Default backend None chosen backend to use from here-on in. None","title":"set_backend"},{"location":"reference/dewret/tasks/#task","text":"def task ( nested : bool = False , flatten_nested : bool = True , is_factory : bool = False ) -> collections . abc . Callable [[ collections . abc . Callable [ ~ Param , ~ RetType ]], collections . abc . Callable [ ~ Param , ~ RetType ]] Decorator factory abstracting backend's own task decorator. For example: >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 If the backend is dask (the default), it is will evaluate this as a dask.delayed . Note that, with any backend, dewret will hijack the decorator to record the attempted evalution rather than actually evaluating the lazy function. Nonetheless, this hijacking will still be executed with the backend's lazy executor, so dask.delayed will still be called, for example, in the dask case. Parameters: Name Type Description Default nested None whether this should be executed to find other tasks. None flatten_nested None (only relevant to nested tasks) should this nested task be considered a distinct subworkflow, or is it just organizational for the outer workflow. None is_factory None whether this task should be marked as a 'factory', rather than a normal step. None Returns: Type Description None Decorator for the current backend to mark lazy-executable tasks. Raises: Type Description TypeError if arguments are missing or incorrect, in line with usual Python behaviour.","title":"task"},{"location":"reference/dewret/tasks/#unwrap","text":"def unwrap ( task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. Ideally, we could use the __wrapped__ property but not all workflow engines support this, and most importantly, dask has only done so as of 2024.03. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function.","title":"unwrap"},{"location":"reference/dewret/tasks/#workflow","text":"def workflow ( ) -> collections . abc . Callable [[ collections . abc . Callable [ ~ Param , ~ RetType ]], collections . abc . Callable [ ~ Param , ~ RetType ]] Shortcut for marking a task as nested. A nested task is one which calls other tasks and does not do anything else important. It will not actually get called at runtime, but should map entirely into the graph. As such, arithmetic operations on results, etc. will cause errors at render-time. Combining tasks is acceptable, and intended. The effect of the nested task will be considered equivalent to whatever reaching whatever step reference is returned at the end. >>> @task () ... def increment ( num : int ) -> int : ... return num + 1 >>> @workflow () ... def double_increment ( num : int ) -> int : ... return increment ( increment ( num = num )) Returns: Type Description None Task that runs at render, not execution, time.","title":"workflow"},{"location":"reference/dewret/tasks/#classes","text":"","title":"Classes"},{"location":"reference/dewret/tasks/#backend","text":"class Backend ( * args , ** kwds ) Stringy enum representing available backends.","title":"Backend"},{"location":"reference/dewret/tasks/#ancestors-in-mro","text":"enum.Enum","title":"Ancestors (in MRO)"},{"location":"reference/dewret/tasks/#class-variables","text":"DASK name value","title":"Class variables"},{"location":"reference/dewret/tasks/#taskexception","text":"class TaskException ( task : dewret . workflow . Task | collections . abc . Callable [ ... , typing . Any ], dec_tb : traceback | None , tb : traceback | None , message : str , * args : Any , ** kwargs : Any ) Exception tied to a specific task. Primarily aimed at parsing issues, but this will ensure that a message is shown with useful debug information for the workflow writer.","title":"TaskException"},{"location":"reference/dewret/tasks/#ancestors-in-mro_1","text":"builtins.Exception builtins.BaseException","title":"Ancestors (in MRO)"},{"location":"reference/dewret/tasks/#class-variables_1","text":"args","title":"Class variables"},{"location":"reference/dewret/tasks/#methods","text":"","title":"Methods"},{"location":"reference/dewret/tasks/#add_note","text":"def add_note ( ... ) Exception.add_note(note) -- add a note to the exception","title":"add_note"},{"location":"reference/dewret/tasks/#with_traceback","text":"def with_traceback ( ... ) Exception.with_traceback(tb) -- set self. traceback to tb and return self.","title":"with_traceback"},{"location":"reference/dewret/tasks/#taskmanager","text":"class TaskManager ( / , * args , ** kwargs ) Overarching backend-agnostic task manager. Gatekeeps the specific backend implementation. This can be instantiated without choosing a backend, but the first call to any of its methods will concretize that choice - either as the default, or the backend set via TaskManager.set_backend . It cannot be changed after this point.","title":"TaskManager"},{"location":"reference/dewret/tasks/#methods_1","text":"","title":"Methods"},{"location":"reference/dewret/tasks/#backend_1","text":"def backend ( ... ) Import backend module. Cached property to load the backend module, if it has not been already. Returns: Type Description None Backend module for the specific choice of backend.","title":"backend"},{"location":"reference/dewret/tasks/#ensure_lazy_1","text":"def ensure_lazy ( self , task : Any ) -> dewret . workflow . Lazy | None Evaluate a single task for a known workflow. As we mask our lazy-evaluable functions to appear as their original types to the type system (see dewret.tasks.task ), we must cast them back, to allow the type-checker to comb the remainder of the code. Parameters: Name Type Description Default task None the suspected task to check. None Returns: Type Description None Original task, cast to a Lazy, or None.","title":"ensure_lazy"},{"location":"reference/dewret/tasks/#evaluate_1","text":"def evaluate ( self , task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], __workflow__ : dewret . workflow . Workflow , thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Evaluate a single task for a known workflow. Parameters: Name Type Description Default task None the task to evaluate. None workflow None workflow within which this exists. None thread_pool None existing pool of threads to run this in, or None. None **kwargs None any arguments to pass to the task. None","title":"evaluate"},{"location":"reference/dewret/tasks/#make_lazy","text":"def make_lazy ( self ) -> collections . abc . Callable [[ collections . abc . Callable [ ... , typing . Any ]], dewret . workflow . Lazy ] Get the lazy decorator for this backend. Returns: Type Description None Real decorator for this backend.","title":"make_lazy"},{"location":"reference/dewret/tasks/#set_backend_1","text":"def set_backend ( self , backend : dewret . tasks . Backend ) -> dewret . tasks . Backend Choose a backend. Sets the backend, provided it has not already been loaded. Parameters: Name Type Description Default backend None chosen backend, to override the default. None Returns: Type Description None Backend that was set. Raises: Type Description RuntimeError when a backend has already been loaded.","title":"set_backend"},{"location":"reference/dewret/tasks/#unwrap_1","text":"def unwrap ( self , task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. Ideally, we could use the __wrapped__ property but not all workflow engines support this, and most importantly, dask has only done so as of 2024.03. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function.","title":"unwrap"},{"location":"reference/dewret/utils/","text":"Module dewret.utils Utility module. General types and functions to centralize common logic. Functions crawl_raw def crawl_raw ( value : Any , action : Optional [ Callable [[ Any ], Any ]] = None ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Takes a Raw-like structure and makes it RawType. Particularly useful for squashing any TypedDicts. Parameters: Name Type Description Default value None value to squash None action None an callback to apply to each found entry, or None. None ensure_raw def ensure_raw ( value : Any , cast_tuple : bool = False ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Check if a variable counts as \"raw\". This works around a checking issue that isinstance of a union of types assigned to a variable, such as RawType , may throw errors even though Python 3.11+ does not. Instead, we explicitly make the full union in the statement below. firm_to_raw def firm_to_raw ( value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | list [ 'FirmType' ] | dict [ str , 'FirmType' ] | tuple [ 'FirmType' , ... ] ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Convenience wrapper for firm structures. Turns structures that would be raw, except for tuples, into raw structures by mapping any tuples to lists. Parameters: Name Type Description Default value None a firm structure (contains raw/tuple values). None flatten_if_set def flatten_if_set ( value : Any ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset Takes a Raw-like structure and makes it RawType or Unset. Flattens if the value is set, but otherwise returns the unset sentinel value as-is. Parameters: Name Type Description Default value None value to squash None hasher def hasher ( construct : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | list [ 'FirmType' ] | dict [ str , 'FirmType' ] | tuple [ 'FirmType' , ... ] ) -> str Consistently hash a RawType or tuple structure. Turns a possibly nested structure of basic types, dicts, lists and tuples into a consistent hash. Parameters: Name Type Description Default construct None structure to hash. None Returns: Type Description None Hash string that should be unique to the construct. The limits of this uniqueness have not yet been explicitly calculated. is_expr def is_expr ( value : Any , permitted_references : type = < class ' dewret . core . Reference '> ) -> bool Confirms whether a structure has only raw or expression types. Parameters: Name Type Description Default value None a crawlable structure. None permitted_references None a class representing the allowed types of References. None is_firm def is_firm ( value : Any , check : Optional [ Callable [[ Any ], bool ]] = None ) -> bool Confirms whether a function is firm. That is, whether its contents are raw or tuples. Parameters: Name Type Description Default value None value to check. None check None any additional check to apply. None is_raw def is_raw ( value : Any , check : Optional [ Callable [[ Any ], bool ]] = None ) -> bool Check if a variable counts as \"raw\". This works around a checking issue that isinstance of a union of types assigned to a variable, such as RawType , may throw errors even though Python 3.11+ does not. Instead, we explicitly make the full union in the statement below. is_raw_type def is_raw_type ( typ : type ) -> bool Check if a type counts as \"raw\". load_module_or_package def load_module_or_package ( target_name : str , path : pathlib . Path ) -> module Convenience loader for modules. If an __init__.py is found in the same location as the target, it will try to load the renderer module as if it is contained in a package and, if it cannot, will fall back to loading the single file. Parameters: Name Type Description Default target_name None module name that should appear in sys.modules . None path None location of the module. None make_traceback def make_traceback ( skip : int = 2 ) -> traceback | None Creates a traceback for the current frame. Necessary to allow tracebacks to be prepped for potential errors in lazy-evaluated functions. Parameters: Name Type Description Default skip None number of frames to skip before starting traceback. None Classes DataclassProtocol class DataclassProtocol ( * args , ** kwargs ) Format of a dataclass. Since dataclasses do not expose a proper type, we use this to represent them. Ancestors (in MRO) typing.Protocol typing.Generic Unset class Unset ( / , * args , ** kwargs ) Unset variable, with no default value. Descendants dewret.workflow.UnsetType","title":"Utils"},{"location":"reference/dewret/utils/#module-dewretutils","text":"Utility module. General types and functions to centralize common logic.","title":"Module dewret.utils"},{"location":"reference/dewret/utils/#functions","text":"","title":"Functions"},{"location":"reference/dewret/utils/#crawl_raw","text":"def crawl_raw ( value : Any , action : Optional [ Callable [[ Any ], Any ]] = None ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Takes a Raw-like structure and makes it RawType. Particularly useful for squashing any TypedDicts. Parameters: Name Type Description Default value None value to squash None action None an callback to apply to each found entry, or None. None","title":"crawl_raw"},{"location":"reference/dewret/utils/#ensure_raw","text":"def ensure_raw ( value : Any , cast_tuple : bool = False ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Check if a variable counts as \"raw\". This works around a checking issue that isinstance of a union of types assigned to a variable, such as RawType , may throw errors even though Python 3.11+ does not. Instead, we explicitly make the full union in the statement below.","title":"ensure_raw"},{"location":"reference/dewret/utils/#firm_to_raw","text":"def firm_to_raw ( value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | list [ 'FirmType' ] | dict [ str , 'FirmType' ] | tuple [ 'FirmType' , ... ] ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] Convenience wrapper for firm structures. Turns structures that would be raw, except for tuples, into raw structures by mapping any tuples to lists. Parameters: Name Type Description Default value None a firm structure (contains raw/tuple values). None","title":"firm_to_raw"},{"location":"reference/dewret/utils/#flatten_if_set","text":"def flatten_if_set ( value : Any ) -> str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset Takes a Raw-like structure and makes it RawType or Unset. Flattens if the value is set, but otherwise returns the unset sentinel value as-is. Parameters: Name Type Description Default value None value to squash None","title":"flatten_if_set"},{"location":"reference/dewret/utils/#hasher","text":"def hasher ( construct : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | list [ 'FirmType' ] | dict [ str , 'FirmType' ] | tuple [ 'FirmType' , ... ] ) -> str Consistently hash a RawType or tuple structure. Turns a possibly nested structure of basic types, dicts, lists and tuples into a consistent hash. Parameters: Name Type Description Default construct None structure to hash. None Returns: Type Description None Hash string that should be unique to the construct. The limits of this uniqueness have not yet been explicitly calculated.","title":"hasher"},{"location":"reference/dewret/utils/#is_expr","text":"def is_expr ( value : Any , permitted_references : type = < class ' dewret . core . Reference '> ) -> bool Confirms whether a structure has only raw or expression types. Parameters: Name Type Description Default value None a crawlable structure. None permitted_references None a class representing the allowed types of References. None","title":"is_expr"},{"location":"reference/dewret/utils/#is_firm","text":"def is_firm ( value : Any , check : Optional [ Callable [[ Any ], bool ]] = None ) -> bool Confirms whether a function is firm. That is, whether its contents are raw or tuples. Parameters: Name Type Description Default value None value to check. None check None any additional check to apply. None","title":"is_firm"},{"location":"reference/dewret/utils/#is_raw","text":"def is_raw ( value : Any , check : Optional [ Callable [[ Any ], bool ]] = None ) -> bool Check if a variable counts as \"raw\". This works around a checking issue that isinstance of a union of types assigned to a variable, such as RawType , may throw errors even though Python 3.11+ does not. Instead, we explicitly make the full union in the statement below.","title":"is_raw"},{"location":"reference/dewret/utils/#is_raw_type","text":"def is_raw_type ( typ : type ) -> bool Check if a type counts as \"raw\".","title":"is_raw_type"},{"location":"reference/dewret/utils/#load_module_or_package","text":"def load_module_or_package ( target_name : str , path : pathlib . Path ) -> module Convenience loader for modules. If an __init__.py is found in the same location as the target, it will try to load the renderer module as if it is contained in a package and, if it cannot, will fall back to loading the single file. Parameters: Name Type Description Default target_name None module name that should appear in sys.modules . None path None location of the module. None","title":"load_module_or_package"},{"location":"reference/dewret/utils/#make_traceback","text":"def make_traceback ( skip : int = 2 ) -> traceback | None Creates a traceback for the current frame. Necessary to allow tracebacks to be prepped for potential errors in lazy-evaluated functions. Parameters: Name Type Description Default skip None number of frames to skip before starting traceback. None","title":"make_traceback"},{"location":"reference/dewret/utils/#classes","text":"","title":"Classes"},{"location":"reference/dewret/utils/#dataclassprotocol","text":"class DataclassProtocol ( * args , ** kwargs ) Format of a dataclass. Since dataclasses do not expose a proper type, we use this to represent them.","title":"DataclassProtocol"},{"location":"reference/dewret/utils/#ancestors-in-mro","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/utils/#unset","text":"class Unset ( / , * args , ** kwargs ) Unset variable, with no default value.","title":"Unset"},{"location":"reference/dewret/utils/#descendants","text":"dewret.workflow.UnsetType","title":"Descendants"},{"location":"reference/dewret/workflow/","text":"Module dewret.workflow Overarching workflow concepts. Basic constructs for describing a workflow. Variables AVAILABLE_TYPES CHECK_IDS LazyFactory RetType StepExecution T TYPE_CHECKING Target U UNSET logger Functions expr_to_references def expr_to_references ( expression : 'Any' , remap : 'Callable[[Any], Any] | None' = None ) -> 'tuple[ExprType, list[Reference[Any] | Parameter[Any]]]' Pull out any references, or other free symbols, from an expression. Parameters: Name Type Description Default expression None normally a reference that can be immediately returned, but may be a sympy expression or a dict/tuple/list/etc. of such. None remap None a callable to project certain values down before extracting symbols, or None. None is_task def is_task ( task : 'Lazy' ) -> 'bool' Decide whether this is a task. Checks whether the wrapped function has the magic attribute __step_expression__ set to True, which is done within task creation. Parameters: Name Type Description Default task None lazy-evaluated value, suspected to be a task. None Returns: Type Description None True if task is indeed a task. param def param ( name : 'str' , default : 'T | UnsetType[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > , tethered : 'Literal[False] | None | Step | Workflow' = False , typ : 'type[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > , autoname : 'bool' = False ) -> 'T' Create a parameter. Will cast so it looks like the original type. Returns: Type Description None Parameter class cast to the type of the supplied default. unify_workflows def unify_workflows ( expression : 'Any' , base_workflow : 'Workflow | None' , set_only : 'bool' = False ) -> 'tuple[Basic | None, Workflow | None]' Takes an expression and ensures all of its references exist in the same workflow. Parameters: Name Type Description Default expression None any valid argument to dewret.workflow.expr_to_references . None base_workflow None the desired workflow to align on, or None. None set_only None whether to bother assimilating all the workflows (False), or to assume that has been done (False). None Classes BaseStep class BaseStep ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Lazy-evaluated function call. Individual function call to a lazy-evaluatable function, tracked for building up the Workflow . Attributes Name Type Description Default task None the Task being called in this step. None arguments None key-value pairs of arguments to this step. None Ancestors (in MRO) dewret.core.WorkflowComponent Descendants dewret.workflow.NestedStep dewret.workflow.Step Class variables positional_args Instance variables id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value. Methods make_reference def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None set_workflow def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None FactoryCall class FactoryCall ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Call to a factory function. Ancestors (in MRO) dewret.workflow.Step dewret.workflow.BaseStep dewret.core.WorkflowComponent Class variables positional_args Instance variables id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value. Methods make_reference def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None set_workflow def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None FieldableMixin class FieldableMixin ( self : 'FieldableProtocol' , * args : 'Any' , field : 'str | int | tuple[str | int, ...] | None' = None , ** kwargs : 'Any' ) Tooling for enhancing a type with referenceable fields. Descendants dewret.workflow.ParameterReference dewret.workflow.StepReference Methods find_field def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference. FieldableProtocol class FieldableProtocol ( * args : 'Any' , field : 'str | None' = None , ** kwargs : 'Any' ) Expected interfaces for a type that can take fields. Attributes Name Type Description Default field None tuple representing the named fields, either strings or integers. None Ancestors (in MRO) typing.Protocol typing.Generic Instance variables name The name for the target, accounting for the field. IterableParameterReference class IterableParameterReference ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Iterable form of parameter references. Ancestors (in MRO) dewret.core.IterableMixin dewret.workflow.ParameterReference dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Class variables ParameterReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. find_field def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. IterableStepReference class IterableStepReference ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Iterable form of a step reference. Ancestors (in MRO) dewret.core.IterableMixin dewret.workflow.StepReference dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Class variables StepReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. find_field def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. Lazy class Lazy ( * args , ** kwargs ) Requirements for a lazy-evaluatable function. Ancestors (in MRO) typing.Protocol typing.Generic Descendants dewret.workflow.LazyEvaluation LazyEvaluation class LazyEvaluation ( fn : 'Callable[..., RetType]' ) Tracks a single evaluation of a lazy function. Ancestors (in MRO) dewret.workflow.Lazy typing.Protocol typing.Generic NestedStep class NestedStep ( workflow : 'Workflow' , name : 'str' , subworkflow : 'Workflow' , arguments : 'Mapping[str, Basic | Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Calling out to a subworkflow. Type of BaseStep to call a subworkflow, which holds a reference to it. Ancestors (in MRO) dewret.workflow.BaseStep dewret.core.WorkflowComponent Class variables positional_args Instance variables id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value. subworkflow Subworkflow that is wrapped. Methods make_reference def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None set_workflow def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None Parameter class Parameter ( name : 'str' , default : 'T | UnsetType[T]' , tethered : 'Literal[False] | None | Step | Workflow' = None , autoname : 'bool' = False , typ : 'type[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > ) Global parameter. Independent parameter that will be used when a task is spotted reaching outside its scope. This wraps the variable it uses. To allow for potential arithmetic operations, etc. it is a Sympy symbol. Attributes Name Type Description Default name None name of the parameter. None default None captured default value from the original value. None Ancestors (in MRO) typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin Class variables autoname default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) is_loopable def is_loopable ( typ : 'type' ) -> 'bool' Checks if this type can be looped over. In particular, checks if this is an iterable that is NOT a str or bytes, possibly disguised behind an Annotated. Parameters: Name Type Description Default typ None type to check. None Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} default Retrieve default value for this parameter, or an unset token. expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Extended name, suitable for rendering. This attempts to create a unique name by tying the parameter to a step if the user has not explicitly provided a name, ideally the one where we discovered it. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). make_reference def make_reference ( self , ** kwargs : 'Any' ) -> \"'ParameterReference[T]'\" Creates a new reference for the parameter. The kwargs will be passed to the constructor, but the Parameters: Name Type Description Default typ None type of the new reference's target. None **kwargs None arguments to pass to the constructor. None match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions register_caller def register_caller ( self , caller : 'BaseStep' ) -> 'None' Capture a step that uses this parameter. Gathers together the steps using this parameter. The first found will be recorded as the tethered step, and used for forming the name. removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. ParameterReference class ParameterReference ( parameter : 'Parameter[U]' , * args : 'Any' , typ : 'type[U] | None' = None , ** kwargs : 'Any' ) Reference to an individual Parameter . Allows us to refer to the outputs of a Parameter in subsequent Parameter arguments. Attributes Name Type Description Default parameter None Parameter referred to. None workflow None Related workflow. In this case, as Parameters are generic but ParameterReferences are specific, this carries the actual workflow reference. None Ancestors (in MRO) dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Descendants dewret.workflow.IterableParameterReference Class variables ParameterReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. find_field def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. Step class Step ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Regular step. Ancestors (in MRO) dewret.workflow.BaseStep dewret.core.WorkflowComponent Descendants dewret.workflow.FactoryCall Class variables positional_args Instance variables id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value. Methods make_reference def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None set_workflow def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None StepReference class StepReference ( step : 'BaseStep' , * args : 'Any' , typ : 'type[U] | None' = None , ** kwargs : 'Any' ) Reference to an individual Step . Allows us to refer to the outputs of a Step in subsequent Step arguments. Attributes Name Type Description Default _ None metadata wrapping the Step referred to. None Ancestors (in MRO) dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent Descendants dewret.workflow.IterableStepReference Class variables StepReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol Static methods class_key def class_key ( ) Nice order of classes. fromiter def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first. Examples from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4) Instance variables args Returns a tuple of arguments of 'self'. Examples from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y Notes Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression. Examples from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args) Examples from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference. Methods adjoint def adjoint ( self ) apart def apart ( self , x = None , ** args ) See the apart function in sympy.polys args_cnc def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self. Explanation self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False. Examples from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []] as_base_exp def as_base_exp ( self ) -> 'tuple[Expr, Expr]' as_coeff_Add def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation. as_coeff_Mul def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product. as_coeff_add def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ()) as_coeff_exponent def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression. as_coeff_mul def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ()) as_coefficient def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None. Examples from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I) See Also coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used as_coefficients_dict def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned. Examples from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x} as_content_primitive def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self). Examples from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y) as_dummy def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned. Examples from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r Notes Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object. as_expr def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression. Examples from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x) as_independent def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True Examples -- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b)) See Also separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul as_leading_term def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value. Examples from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2) as_numer_denom def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else. See Also normal: return a/b instead of (a, b) as_ordered_factors def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self]. as_ordered_terms def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms. Examples from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1] as_poly def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None . Explanation from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None as_powers_dict def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary. See Also as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors. as_real_imag def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z)) as_set def as_set ( self ) Rewrites Boolean expression in terms of real sets. Examples from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo)) as_terms def as_terms ( self ) Transform an expression to a list of terms. aseries def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) . Parameters self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form. Examples from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x Returns Expr Asymptotic series expansion of the expression. Notes This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self . References .. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion See Also Expr.aseries: See the docstring of this function for complete details of this wrapper. atoms def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below. Examples from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)} cancel def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys coeff def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned. Explanation When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative. Examples from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1 See Also as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used collect def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify combsimp def combsimp ( self ) See the combsimp function in sympy.simplify compare def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned. Examples from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1 compute_leading_term def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first. conjugate def conjugate ( self ) Returns the complex conjugate of 'self'. copy def copy ( self ) could_extract_minus_sign def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False. Examples from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True count def count ( self , query ) Count the number of matching subexpressions. count_ops def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count. diff def diff ( self , * symbols , ** assumptions ) dir def dir ( self , x , cdir ) doit def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x) dummy_eq def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols. Examples from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False equals def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None. Explanation If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False. evalf def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 expand def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information. extract_additively def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None. Examples from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3 See Also extract_multiplicatively coeff as_coefficient extract_branch_factor def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2) extract_multiplicatively def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self. Examples from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6 factor def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools find def find ( self , query , group = False ) Find all subexpressions matching a query. find_field def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference. fourier_series def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information. fps def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information. gammasimp def gammasimp ( self ) See the gammasimp function in sympy.simplify getO def getO ( self ) Returns the additive O(..) symbol if there is one, else None. getn def getn ( self ) Returns the order of the expression. Explanation The order is determined either from the O(...) term. If there is no O(...) term, it returns None. Examples from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn() has def has ( self , * patterns ) Test whether any subexpression matches any of the patterns. Examples from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False has_free def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False. Examples from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True has_xfree def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches. Examples from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False integrate def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals invert def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions). See Also sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert is_algebraic_expr def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation. Examples from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True See Also is_rational_function References .. [1] https://en.wikipedia.org/wiki/Algebraic_expression is_constant def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively. Explanation If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing. Examples from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True is_hypergeometric def is_hypergeometric ( self , k ) is_meromorphic def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis. Examples from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False is_polynomial def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True). Examples from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function() is_rational_function def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True). Examples from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr(). is_same def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5). Examples In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False leadterm def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b). Examples from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2) limit def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim. lseries def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries(). match def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self Examples from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2} matches def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr. Examples from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c} n def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits. Parameters subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information. Notes When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000 normal def normal ( self ) Return the expression as a fraction. expression -> a/b See Also as_numer_denom: return (a, b) instead of a/b nseries def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries(). Examples from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y) nsimplify def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify powsimp def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify primitive def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float). Examples from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True radsimp def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify ratsimp def ratsimp ( self ) See the ratsimp function in sympy.simplify rcall def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z refine def refine ( self , assumption = True ) See the refine function in sympy.assumptions removeO def removeO ( self ) Removes the additive O(..) symbol if there is one replace def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below: Examples Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1 See Also subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules rewrite def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten. Parameters args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True . Examples If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2) round def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number. Examples from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I Notes The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True separate def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify series def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised. Parameters expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated. Examples from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x Returns Expr : Expression Series expansion of the expression about x0 Raises TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object simplify def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify sort_key def sort_key ( self , order = None ) Return a sort key. Examples from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2] subs def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made. Examples from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained. See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision taylor_term def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\". to_nnf def to_nnf ( self , simplify = True ) together def together ( self , * args , ** kwargs ) See the together function in sympy.polys transpose def transpose ( self ) trigsimp def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify xreplace def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression. Parameters rule : dict-like Expresses a replacement rule Returns xreplace : the result of the replacement Examples from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),) See Also replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves. Task class Task ( name : 'str' , target : 'Lazy' ) Named wrapper of a lazy-evaluatable function. Wraps a lazy-evaluatable function ( dewret.workflow.Lazy ) with any metadata needed to render it later. At present, this is the name. Attributes Name Type Description Default name None Name of the lazy function as it will appear in the output workflow text. None target None Callable that is wrapped. None UnsetType class UnsetType ( raw_type : 'type[T]' ) Unset variable with a specific type. Attributes Name Type Description Default type None type of the variable. None Ancestors (in MRO) dewret.utils.Unset typing.Generic Workflow class Workflow ( name : 'str | None' = None ) Overarching workflow concept. Represents a whole workflow, as a singleton maintaining all state information needed ahead of rendering. It is built up as the lazy-evaluations are finally evaluated. Attributes Name Type Description Default steps None the sequence of calls to lazy-evaluable functions, built as they are evaluated. None tasks None the mapping of names used in the steps to the actual Task wrappers they represent. None result None target reference to evaluate, if yet present. None Static methods assimilate def assimilate ( * workflow_args : 'Workflow' ) -> \"'Workflow'\" Combine two Workflows into one Workflow. Takes two workflows and unifies them by combining steps and tasks. If it sees mismatched identifiers for the same component, it will error. This could happen if the hashing function is flawed or some Python magic to do with Targets being passed. Parameters: Name Type Description Default workflow_args None workflows to use as base None from_result def from_result ( result : 'StepReference[Any] | list[StepReference[Any]] | tuple[StepReference[Any], ...]' , simplify_ids : 'bool' = False , nested : 'bool' = True ) -> 'Workflow' Create from a desired result. Starts from a result, and builds a workflow to output it. Instance variables has_result Confirms whether this workflow has a non-empty result. Either None or an empty list/tuple are considered empty for this purpose. Returns: True if the workflow has a result, False otherwise. id Consistent ID based off the step IDs. indexed_steps Steps mapped by ID. Forces generation of IDs. Note that this effectively freezes the steps, so it should not be used until we are confident the steps are all ready to be hashed. name Get the name of the workflow. result_type Overall return type of this workflow. steps Get deduplicated steps. Returns: steps for looping over without duplicates. Methods add_nested_step def add_nested_step ( self , name : 'str' , subworkflow : 'Workflow' , return_type : 'type | None' , kwargs : 'dict[str, Any]' , positional_args : 'dict[str, bool] | None' = None ) -> 'StepReference[Any]' Append a nested step. Calls a subworkflow. Parameters: Name Type Description Default name None name of the subworkflow. None subworkflow None the subworkflow itself. None return_type None a forced type for the return, or None. None kwargs None any key-value arguments to pass in the call. None positional_args None a mapping of arguments to bools, True if the argument is positional or otherwise False. None add_step def add_step ( self , fn : 'Lazy' , kwargs : 'dict[str, Raw | Reference[Any]]' , raw_as_parameter : 'bool' = False , is_factory : 'bool' = False , positional_args : 'dict[str, bool] | None' = None ) -> 'StepReference[Any]' Append a step. Adds a step, for running a target with key-value arguments, to the workflow. Parameters: Name Type Description Default fn None the target function to turn into a step. None kwargs None any key-value arguments to pass in the call. None raw_as_parameter None whether to turn any discovered raw arguments into workflow parameters. None is_factory None whether this step should be a Factory. None positional_args None a mapping of arguments to bools, True if the argument is positional or otherwise False. None find_factories def find_factories ( self ) -> 'dict[str, FactoryCall]' Steps that are factory calls. find_parameters def find_parameters ( self , include_factory_calls : 'bool' = True ) -> 'set[Parameter[Any]]' Crawl steps for parameter references. As the workflow does not hold its own list of parameters, this dynamically finds them. Returns: Type Description None Set of all references to parameters across the steps. register_task def register_task ( self , fn : 'Lazy' ) -> 'Task' Note the existence of a lazy-evaluatable function, and wrap it as a Task . Parameters: Name Type Description Default fn None the wrapped function. None Returns: Type Description None A new Task that wraps the function, and is retained in the Workflow.tasks dict. remap def remap ( self , step_id : 'str' ) -> 'str' Apply name simplification if requested. Parameters: Name Type Description Default step_id None step to check. None Returns: Type Description None Same ID or a remapped name. set_result def set_result ( self , result : 'Basic | list[Basic] | tuple[Basic]' ) -> 'None' Choose the result step. Sets a step as being the result for the entire workflow. When we evaluate a dynamic workflow, the engine (e.g. dask) creates a graph to realize the result of a single collection. Similarly, in the static case, we need to have a result that drives the calculation. Parameters: Name Type Description Default result None reference to the chosen step. None simplify_ids def simplify_ids ( self , infix : 'list[str] | None' = None ) -> 'None' Work out mapping to simple ints from hashes. Goes through and numbers each step by the order of use of its task. WorkflowLinkedComponent class WorkflowLinkedComponent ( * args , ** kwargs ) Protocol for objects dynamically tied to a Workflow . Ancestors (in MRO) typing.Protocol typing.Generic","title":"Workflow"},{"location":"reference/dewret/workflow/#module-dewretworkflow","text":"Overarching workflow concepts. Basic constructs for describing a workflow.","title":"Module dewret.workflow"},{"location":"reference/dewret/workflow/#variables","text":"AVAILABLE_TYPES CHECK_IDS LazyFactory RetType StepExecution T TYPE_CHECKING Target U UNSET logger","title":"Variables"},{"location":"reference/dewret/workflow/#functions","text":"","title":"Functions"},{"location":"reference/dewret/workflow/#expr_to_references","text":"def expr_to_references ( expression : 'Any' , remap : 'Callable[[Any], Any] | None' = None ) -> 'tuple[ExprType, list[Reference[Any] | Parameter[Any]]]' Pull out any references, or other free symbols, from an expression. Parameters: Name Type Description Default expression None normally a reference that can be immediately returned, but may be a sympy expression or a dict/tuple/list/etc. of such. None remap None a callable to project certain values down before extracting symbols, or None. None","title":"expr_to_references"},{"location":"reference/dewret/workflow/#is_task","text":"def is_task ( task : 'Lazy' ) -> 'bool' Decide whether this is a task. Checks whether the wrapped function has the magic attribute __step_expression__ set to True, which is done within task creation. Parameters: Name Type Description Default task None lazy-evaluated value, suspected to be a task. None Returns: Type Description None True if task is indeed a task.","title":"is_task"},{"location":"reference/dewret/workflow/#param","text":"def param ( name : 'str' , default : 'T | UnsetType[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > , tethered : 'Literal[False] | None | Step | Workflow' = False , typ : 'type[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > , autoname : 'bool' = False ) -> 'T' Create a parameter. Will cast so it looks like the original type. Returns: Type Description None Parameter class cast to the type of the supplied default.","title":"param"},{"location":"reference/dewret/workflow/#unify_workflows","text":"def unify_workflows ( expression : 'Any' , base_workflow : 'Workflow | None' , set_only : 'bool' = False ) -> 'tuple[Basic | None, Workflow | None]' Takes an expression and ensures all of its references exist in the same workflow. Parameters: Name Type Description Default expression None any valid argument to dewret.workflow.expr_to_references . None base_workflow None the desired workflow to align on, or None. None set_only None whether to bother assimilating all the workflows (False), or to assume that has been done (False). None","title":"unify_workflows"},{"location":"reference/dewret/workflow/#classes","text":"","title":"Classes"},{"location":"reference/dewret/workflow/#basestep","text":"class BaseStep ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Lazy-evaluated function call. Individual function call to a lazy-evaluatable function, tracked for building up the Workflow .","title":"BaseStep"},{"location":"reference/dewret/workflow/#attributes","text":"Name Type Description Default task None the Task being called in this step. None arguments None key-value pairs of arguments to this step. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro","text":"dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#descendants","text":"dewret.workflow.NestedStep dewret.workflow.Step","title":"Descendants"},{"location":"reference/dewret/workflow/#class-variables","text":"positional_args","title":"Class variables"},{"location":"reference/dewret/workflow/#instance-variables","text":"id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value.","title":"Instance variables"},{"location":"reference/dewret/workflow/#methods","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#make_reference","text":"def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None","title":"make_reference"},{"location":"reference/dewret/workflow/#set_workflow","text":"def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None","title":"set_workflow"},{"location":"reference/dewret/workflow/#factorycall","text":"class FactoryCall ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Call to a factory function.","title":"FactoryCall"},{"location":"reference/dewret/workflow/#ancestors-in-mro_1","text":"dewret.workflow.Step dewret.workflow.BaseStep dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#class-variables_1","text":"positional_args","title":"Class variables"},{"location":"reference/dewret/workflow/#instance-variables_1","text":"id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value.","title":"Instance variables"},{"location":"reference/dewret/workflow/#methods_1","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#make_reference_1","text":"def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None","title":"make_reference"},{"location":"reference/dewret/workflow/#set_workflow_1","text":"def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None","title":"set_workflow"},{"location":"reference/dewret/workflow/#fieldablemixin","text":"class FieldableMixin ( self : 'FieldableProtocol' , * args : 'Any' , field : 'str | int | tuple[str | int, ...] | None' = None , ** kwargs : 'Any' ) Tooling for enhancing a type with referenceable fields.","title":"FieldableMixin"},{"location":"reference/dewret/workflow/#descendants_1","text":"dewret.workflow.ParameterReference dewret.workflow.StepReference","title":"Descendants"},{"location":"reference/dewret/workflow/#methods_2","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#find_field","text":"def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference.","title":"find_field"},{"location":"reference/dewret/workflow/#fieldableprotocol","text":"class FieldableProtocol ( * args : 'Any' , field : 'str | None' = None , ** kwargs : 'Any' ) Expected interfaces for a type that can take fields.","title":"FieldableProtocol"},{"location":"reference/dewret/workflow/#attributes_1","text":"Name Type Description Default field None tuple representing the named fields, either strings or integers. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro_2","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#instance-variables_2","text":"name The name for the target, accounting for the field.","title":"Instance variables"},{"location":"reference/dewret/workflow/#iterableparameterreference","text":"class IterableParameterReference ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Iterable form of parameter references.","title":"IterableParameterReference"},{"location":"reference/dewret/workflow/#ancestors-in-mro_3","text":"dewret.core.IterableMixin dewret.workflow.ParameterReference dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#class-variables_2","text":"ParameterReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/workflow/#static-methods","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#class_key","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/workflow/#fromiter","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/workflow/#examples","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/workflow/#instance-variables_3","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/workflow/#examples_1","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/workflow/#notes","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/workflow/#examples_2","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/workflow/#examples_3","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/workflow/#methods_3","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#adjoint","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/workflow/#apart","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/workflow/#args_cnc","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/workflow/#explanation","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_4","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/workflow/#as_base_exp","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/workflow/#as_coeff_add","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/workflow/#as_coeff_mul","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/workflow/#as_coeff_add_1","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/workflow/#as_coeff_exponent","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/workflow/#as_coeff_mul_1","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/workflow/#as_coefficient","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/workflow/#examples_5","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#as_coefficients_dict","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/workflow/#examples_6","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/workflow/#as_content_primitive","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/workflow/#examples_7","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/workflow/#as_dummy","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/workflow/#examples_8","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/workflow/#notes_1","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/workflow/#as_expr","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/workflow/#examples_9","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/workflow/#as_independent","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/workflow/#examples_10","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_1","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/workflow/#as_leading_term","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/workflow/#examples_11","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/workflow/#as_numer_denom","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/workflow/#see-also_2","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/workflow/#as_ordered_factors","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/workflow/#as_ordered_terms","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/workflow/#examples_12","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/workflow/#as_poly","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/workflow/#explanation_1","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/workflow/#as_powers_dict","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/workflow/#see-also_3","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/workflow/#as_real_imag","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/workflow/#as_set","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/workflow/#examples_13","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/workflow/#as_terms","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/workflow/#aseries","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/workflow/#parameters","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_14","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/workflow/#notes_2","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/workflow/#references","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/workflow/#see-also_4","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/workflow/#atoms","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/workflow/#examples_15","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/workflow/#cancel","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/workflow/#coeff","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/workflow/#explanation_2","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_16","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_5","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#collect","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/workflow/#combsimp","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/workflow/#compare","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/workflow/#examples_17","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/workflow/#compute_leading_term","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/workflow/#conjugate","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/workflow/#copy","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/workflow/#could_extract_minus_sign","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/workflow/#examples_18","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/workflow/#count","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/workflow/#count_ops","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/workflow/#diff","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/workflow/#dir","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/workflow/#doit","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/workflow/#dummy_eq","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/workflow/#examples_19","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/workflow/#equals","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/workflow/#explanation_3","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/workflow/#evalf","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/workflow/#parameters_1","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_3","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#expand","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/workflow/#extract_additively","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/workflow/#examples_20","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_6","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/workflow/#extract_branch_factor","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/workflow/#extract_multiplicatively","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/workflow/#examples_21","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/workflow/#factor","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/workflow/#find","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/workflow/#find_field_1","text":"def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference.","title":"find_field"},{"location":"reference/dewret/workflow/#fourier_series","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/workflow/#fps","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/workflow/#gammasimp","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/workflow/#geto","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/workflow/#getn","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/workflow/#explanation_4","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_22","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/workflow/#has","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/workflow/#examples_23","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/workflow/#has_free","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/workflow/#examples_24","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/workflow/#has_xfree","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/workflow/#examples_25","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/workflow/#integrate","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/workflow/#invert","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/workflow/#see-also_7","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/workflow/#is_algebraic_expr","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/workflow/#examples_26","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_8","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/workflow/#references_1","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/workflow/#is_constant","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/workflow/#explanation_5","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_27","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/workflow/#is_hypergeometric","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/workflow/#is_meromorphic","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/workflow/#examples_28","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/workflow/#is_polynomial","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/workflow/#examples_29","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/workflow/#is_rational_function","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/workflow/#examples_30","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/workflow/#is_same","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/workflow/#examples_31","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/workflow/#leadterm","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/workflow/#examples_32","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/workflow/#limit","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/workflow/#lseries","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/workflow/#match","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/workflow/#examples_33","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/workflow/#matches","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/workflow/#examples_34","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/workflow/#n","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/workflow/#parameters_2","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_4","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#normal","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/workflow/#see-also_9","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/workflow/#nseries","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/workflow/#examples_35","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/workflow/#nsimplify","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/workflow/#powsimp","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/workflow/#primitive","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/workflow/#examples_36","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/workflow/#radsimp","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/workflow/#ratsimp","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/workflow/#rcall","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/workflow/#refine","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/workflow/#removeo","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/workflow/#replace","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/workflow/#examples_37","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_10","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/workflow/#rewrite","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/workflow/#parameters_3","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_38","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/workflow/#round","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/workflow/#examples_39","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/workflow/#notes_5","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/workflow/#separate","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/workflow/#series","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/workflow/#parameters_4","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_40","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_1","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/workflow/#raises","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/workflow/#simplify","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/workflow/#sort_key","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/workflow/#examples_41","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/workflow/#subs","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/workflow/#examples_42","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_11","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/workflow/#taylor_term","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/workflow/#to_nnf","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/workflow/#together","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/workflow/#transpose","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/workflow/#trigsimp","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/workflow/#xreplace","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/workflow/#parameters_5","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/workflow/#returns_2","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/workflow/#examples_43","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_12","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/workflow/#iterablestepreference","text":"class IterableStepReference ( typ : type [ ~ U ] | None = None , ** kwargs : Any ) Iterable form of a step reference.","title":"IterableStepReference"},{"location":"reference/dewret/workflow/#ancestors-in-mro_4","text":"dewret.core.IterableMixin dewret.workflow.StepReference dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#class-variables_3","text":"StepReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/workflow/#static-methods_1","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#class_key_1","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/workflow/#fromiter_1","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/workflow/#examples_44","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/workflow/#instance-variables_4","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/workflow/#examples_45","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/workflow/#notes_6","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/workflow/#examples_46","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/workflow/#examples_47","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/workflow/#methods_4","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#adjoint_1","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/workflow/#apart_1","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/workflow/#args_cnc_1","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/workflow/#explanation_6","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_48","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/workflow/#as_base_exp_1","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/workflow/#as_coeff_add_2","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/workflow/#as_coeff_mul_2","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/workflow/#as_coeff_add_3","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/workflow/#as_coeff_exponent_1","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/workflow/#as_coeff_mul_3","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/workflow/#as_coefficient_1","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/workflow/#examples_49","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_13","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#as_coefficients_dict_1","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/workflow/#examples_50","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/workflow/#as_content_primitive_1","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/workflow/#examples_51","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/workflow/#as_dummy_1","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/workflow/#examples_52","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/workflow/#notes_7","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/workflow/#as_expr_1","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/workflow/#examples_53","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/workflow/#as_independent_1","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/workflow/#examples_54","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_14","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/workflow/#as_leading_term_1","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/workflow/#examples_55","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/workflow/#as_numer_denom_1","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/workflow/#see-also_15","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/workflow/#as_ordered_factors_1","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/workflow/#as_ordered_terms_1","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/workflow/#examples_56","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/workflow/#as_poly_1","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/workflow/#explanation_7","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/workflow/#as_powers_dict_1","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/workflow/#see-also_16","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/workflow/#as_real_imag_1","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/workflow/#as_set_1","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/workflow/#examples_57","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/workflow/#as_terms_1","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/workflow/#aseries_1","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/workflow/#parameters_6","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_58","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_3","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/workflow/#notes_8","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/workflow/#references_2","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/workflow/#see-also_17","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/workflow/#atoms_1","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/workflow/#examples_59","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/workflow/#cancel_1","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/workflow/#coeff_1","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/workflow/#explanation_8","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_60","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_18","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#collect_1","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/workflow/#combsimp_1","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/workflow/#compare_1","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/workflow/#examples_61","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/workflow/#compute_leading_term_1","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/workflow/#conjugate_1","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/workflow/#copy_1","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/workflow/#could_extract_minus_sign_1","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/workflow/#examples_62","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/workflow/#count_1","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/workflow/#count_ops_1","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/workflow/#diff_1","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/workflow/#dir_1","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/workflow/#doit_1","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/workflow/#dummy_eq_1","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/workflow/#examples_63","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/workflow/#equals_1","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/workflow/#explanation_9","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/workflow/#evalf_1","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/workflow/#parameters_7","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_9","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#expand_1","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/workflow/#extract_additively_1","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/workflow/#examples_64","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_19","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/workflow/#extract_branch_factor_1","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/workflow/#extract_multiplicatively_1","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/workflow/#examples_65","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/workflow/#factor_1","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/workflow/#find_1","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/workflow/#find_field_2","text":"def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference.","title":"find_field"},{"location":"reference/dewret/workflow/#fourier_series_1","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/workflow/#fps_1","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/workflow/#gammasimp_1","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/workflow/#geto_1","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/workflow/#getn_1","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/workflow/#explanation_10","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_66","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/workflow/#has_1","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/workflow/#examples_67","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/workflow/#has_free_1","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/workflow/#examples_68","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/workflow/#has_xfree_1","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/workflow/#examples_69","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/workflow/#integrate_1","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/workflow/#invert_1","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/workflow/#see-also_20","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/workflow/#is_algebraic_expr_1","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/workflow/#examples_70","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_21","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/workflow/#references_3","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/workflow/#is_constant_1","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/workflow/#explanation_11","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_71","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/workflow/#is_hypergeometric_1","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/workflow/#is_meromorphic_1","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/workflow/#examples_72","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/workflow/#is_polynomial_1","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/workflow/#examples_73","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/workflow/#is_rational_function_1","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/workflow/#examples_74","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/workflow/#is_same_1","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/workflow/#examples_75","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/workflow/#leadterm_1","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/workflow/#examples_76","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/workflow/#limit_1","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/workflow/#lseries_1","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/workflow/#match_1","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/workflow/#examples_77","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/workflow/#matches_1","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/workflow/#examples_78","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/workflow/#n_1","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/workflow/#parameters_8","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_10","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#normal_1","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/workflow/#see-also_22","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/workflow/#nseries_1","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/workflow/#examples_79","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/workflow/#nsimplify_1","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/workflow/#powsimp_1","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/workflow/#primitive_1","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/workflow/#examples_80","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/workflow/#radsimp_1","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/workflow/#ratsimp_1","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/workflow/#rcall_1","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/workflow/#refine_1","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/workflow/#removeo_1","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/workflow/#replace_1","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/workflow/#examples_81","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_23","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/workflow/#rewrite_1","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/workflow/#parameters_9","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_82","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/workflow/#round_1","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/workflow/#examples_83","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/workflow/#notes_11","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/workflow/#separate_1","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/workflow/#series_1","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/workflow/#parameters_10","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_84","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_4","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/workflow/#raises_1","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/workflow/#simplify_1","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/workflow/#sort_key_1","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/workflow/#examples_85","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/workflow/#subs_1","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/workflow/#examples_86","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_24","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/workflow/#taylor_term_1","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/workflow/#to_nnf_1","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/workflow/#together_1","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/workflow/#transpose_1","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/workflow/#trigsimp_1","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/workflow/#xreplace_1","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/workflow/#parameters_11","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/workflow/#returns_5","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/workflow/#examples_87","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_25","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/workflow/#lazy","text":"class Lazy ( * args , ** kwargs ) Requirements for a lazy-evaluatable function.","title":"Lazy"},{"location":"reference/dewret/workflow/#ancestors-in-mro_5","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#descendants_2","text":"dewret.workflow.LazyEvaluation","title":"Descendants"},{"location":"reference/dewret/workflow/#lazyevaluation","text":"class LazyEvaluation ( fn : 'Callable[..., RetType]' ) Tracks a single evaluation of a lazy function.","title":"LazyEvaluation"},{"location":"reference/dewret/workflow/#ancestors-in-mro_6","text":"dewret.workflow.Lazy typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#nestedstep","text":"class NestedStep ( workflow : 'Workflow' , name : 'str' , subworkflow : 'Workflow' , arguments : 'Mapping[str, Basic | Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Calling out to a subworkflow. Type of BaseStep to call a subworkflow, which holds a reference to it.","title":"NestedStep"},{"location":"reference/dewret/workflow/#ancestors-in-mro_7","text":"dewret.workflow.BaseStep dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#class-variables_4","text":"positional_args","title":"Class variables"},{"location":"reference/dewret/workflow/#instance-variables_5","text":"id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value. subworkflow Subworkflow that is wrapped.","title":"Instance variables"},{"location":"reference/dewret/workflow/#methods_5","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#make_reference_2","text":"def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None","title":"make_reference"},{"location":"reference/dewret/workflow/#set_workflow_2","text":"def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None","title":"set_workflow"},{"location":"reference/dewret/workflow/#parameter","text":"class Parameter ( name : 'str' , default : 'T | UnsetType[T]' , tethered : 'Literal[False] | None | Step | Workflow' = None , autoname : 'bool' = False , typ : 'type[T] | Unset' = < dewret . utils . Unset object at 0x7fd689964a10 > ) Global parameter. Independent parameter that will be used when a task is spotted reaching outside its scope. This wraps the variable it uses. To allow for potential arithmetic operations, etc. it is a Sympy symbol.","title":"Parameter"},{"location":"reference/dewret/workflow/#attributes_2","text":"Name Type Description Default name None name of the parameter. None default None captured default value from the original value. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro_8","text":"typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#class-variables_5","text":"autoname default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/workflow/#static-methods_2","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#class_key_2","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/workflow/#fromiter_2","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/workflow/#examples_88","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/workflow/#is_loopable","text":"def is_loopable ( typ : 'type' ) -> 'bool' Checks if this type can be looped over. In particular, checks if this is an iterable that is NOT a str or bytes, possibly disguised behind an Annotated. Parameters: Name Type Description Default typ None type to check. None","title":"is_loopable"},{"location":"reference/dewret/workflow/#instance-variables_6","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/workflow/#examples_89","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/workflow/#notes_12","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/workflow/#examples_90","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} default Retrieve default value for this parameter, or an unset token. expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/workflow/#examples_91","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Extended name, suitable for rendering. This attempts to create a unique name by tying the parameter to a step if the user has not explicitly provided a name, ideally the one where we discovered it.","title":"Examples"},{"location":"reference/dewret/workflow/#methods_6","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#adjoint_2","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/workflow/#apart_2","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/workflow/#args_cnc_2","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/workflow/#explanation_12","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_92","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/workflow/#as_base_exp_2","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/workflow/#as_coeff_add_4","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/workflow/#as_coeff_mul_4","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/workflow/#as_coeff_add_5","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/workflow/#as_coeff_exponent_2","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/workflow/#as_coeff_mul_5","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/workflow/#as_coefficient_2","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/workflow/#examples_93","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_26","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#as_coefficients_dict_2","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/workflow/#examples_94","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/workflow/#as_content_primitive_2","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/workflow/#examples_95","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/workflow/#as_dummy_2","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/workflow/#examples_96","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/workflow/#notes_13","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/workflow/#as_expr_2","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/workflow/#examples_97","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/workflow/#as_independent_2","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/workflow/#examples_98","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_27","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/workflow/#as_leading_term_2","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/workflow/#examples_99","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/workflow/#as_numer_denom_2","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/workflow/#see-also_28","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/workflow/#as_ordered_factors_2","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/workflow/#as_ordered_terms_2","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/workflow/#examples_100","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/workflow/#as_poly_2","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/workflow/#explanation_13","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/workflow/#as_powers_dict_2","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/workflow/#see-also_29","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/workflow/#as_real_imag_2","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/workflow/#as_set_2","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/workflow/#examples_101","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/workflow/#as_terms_2","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/workflow/#aseries_2","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/workflow/#parameters_12","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_102","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_6","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/workflow/#notes_14","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/workflow/#references_4","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/workflow/#see-also_30","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/workflow/#atoms_2","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/workflow/#examples_103","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/workflow/#cancel_2","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/workflow/#coeff_2","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/workflow/#explanation_14","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_104","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_31","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#collect_2","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/workflow/#combsimp_2","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/workflow/#compare_2","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/workflow/#examples_105","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/workflow/#compute_leading_term_2","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/workflow/#conjugate_2","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/workflow/#copy_2","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/workflow/#could_extract_minus_sign_2","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/workflow/#examples_106","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/workflow/#count_2","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/workflow/#count_ops_2","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/workflow/#diff_2","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/workflow/#dir_2","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/workflow/#doit_2","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/workflow/#dummy_eq_2","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/workflow/#examples_107","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/workflow/#equals_2","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/workflow/#explanation_15","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/workflow/#evalf_2","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/workflow/#parameters_13","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_15","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#expand_2","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/workflow/#extract_additively_2","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/workflow/#examples_108","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_32","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/workflow/#extract_branch_factor_2","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/workflow/#extract_multiplicatively_2","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/workflow/#examples_109","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/workflow/#factor_2","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/workflow/#find_2","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/workflow/#fourier_series_2","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/workflow/#fps_2","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/workflow/#gammasimp_2","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/workflow/#geto_2","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/workflow/#getn_2","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/workflow/#explanation_16","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_110","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/workflow/#has_2","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/workflow/#examples_111","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/workflow/#has_free_2","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/workflow/#examples_112","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/workflow/#has_xfree_2","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/workflow/#examples_113","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/workflow/#integrate_2","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/workflow/#invert_2","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/workflow/#see-also_33","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/workflow/#is_algebraic_expr_2","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/workflow/#examples_114","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_34","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/workflow/#references_5","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/workflow/#is_constant_2","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/workflow/#explanation_17","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_115","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/workflow/#is_hypergeometric_2","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/workflow/#is_meromorphic_2","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/workflow/#examples_116","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/workflow/#is_polynomial_2","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/workflow/#examples_117","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/workflow/#is_rational_function_2","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/workflow/#examples_118","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/workflow/#is_same_2","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/workflow/#examples_119","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/workflow/#leadterm_2","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/workflow/#examples_120","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/workflow/#limit_2","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/workflow/#lseries_2","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/workflow/#make_reference_3","text":"def make_reference ( self , ** kwargs : 'Any' ) -> \"'ParameterReference[T]'\" Creates a new reference for the parameter. The kwargs will be passed to the constructor, but the Parameters: Name Type Description Default typ None type of the new reference's target. None **kwargs None arguments to pass to the constructor. None","title":"make_reference"},{"location":"reference/dewret/workflow/#match_2","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/workflow/#examples_121","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/workflow/#matches_2","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/workflow/#examples_122","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/workflow/#n_2","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/workflow/#parameters_14","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_16","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#normal_2","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/workflow/#see-also_35","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/workflow/#nseries_2","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/workflow/#examples_123","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/workflow/#nsimplify_2","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/workflow/#powsimp_2","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/workflow/#primitive_2","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/workflow/#examples_124","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/workflow/#radsimp_2","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/workflow/#ratsimp_2","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/workflow/#rcall_2","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/workflow/#refine_2","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/workflow/#register_caller","text":"def register_caller ( self , caller : 'BaseStep' ) -> 'None' Capture a step that uses this parameter. Gathers together the steps using this parameter. The first found will be recorded as the tethered step, and used for forming the name.","title":"register_caller"},{"location":"reference/dewret/workflow/#removeo_2","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/workflow/#replace_2","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/workflow/#examples_125","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_36","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/workflow/#rewrite_2","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/workflow/#parameters_15","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_126","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/workflow/#round_2","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/workflow/#examples_127","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/workflow/#notes_17","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/workflow/#separate_2","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/workflow/#series_2","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/workflow/#parameters_16","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_128","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_7","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/workflow/#raises_2","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/workflow/#simplify_2","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/workflow/#sort_key_2","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/workflow/#examples_129","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/workflow/#subs_2","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/workflow/#examples_130","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_37","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/workflow/#taylor_term_2","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/workflow/#to_nnf_2","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/workflow/#together_2","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/workflow/#transpose_2","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/workflow/#trigsimp_2","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/workflow/#xreplace_2","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/workflow/#parameters_17","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/workflow/#returns_8","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/workflow/#examples_131","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_38","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/workflow/#parameterreference","text":"class ParameterReference ( parameter : 'Parameter[U]' , * args : 'Any' , typ : 'type[U] | None' = None , ** kwargs : 'Any' ) Reference to an individual Parameter . Allows us to refer to the outputs of a Parameter in subsequent Parameter arguments.","title":"ParameterReference"},{"location":"reference/dewret/workflow/#attributes_3","text":"Name Type Description Default parameter None Parameter referred to. None workflow None Related workflow. In this case, as Parameters are generic but ParameterReferences are specific, this carries the actual workflow reference. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro_9","text":"dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#descendants_3","text":"dewret.workflow.IterableParameterReference","title":"Descendants"},{"location":"reference/dewret/workflow/#class-variables_6","text":"ParameterReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/workflow/#static-methods_3","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#class_key_3","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/workflow/#fromiter_3","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/workflow/#examples_132","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/workflow/#instance-variables_7","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/workflow/#examples_133","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/workflow/#notes_18","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/workflow/#examples_134","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/workflow/#examples_135","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/workflow/#methods_7","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#adjoint_3","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/workflow/#apart_3","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/workflow/#args_cnc_3","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/workflow/#explanation_18","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_136","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/workflow/#as_base_exp_3","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/workflow/#as_coeff_add_6","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/workflow/#as_coeff_mul_6","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/workflow/#as_coeff_add_7","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/workflow/#as_coeff_exponent_3","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/workflow/#as_coeff_mul_7","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/workflow/#as_coefficient_3","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/workflow/#examples_137","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_39","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#as_coefficients_dict_3","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/workflow/#examples_138","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/workflow/#as_content_primitive_3","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/workflow/#examples_139","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/workflow/#as_dummy_3","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/workflow/#examples_140","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/workflow/#notes_19","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/workflow/#as_expr_3","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/workflow/#examples_141","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/workflow/#as_independent_3","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/workflow/#examples_142","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_40","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/workflow/#as_leading_term_3","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/workflow/#examples_143","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/workflow/#as_numer_denom_3","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/workflow/#see-also_41","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/workflow/#as_ordered_factors_3","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/workflow/#as_ordered_terms_3","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/workflow/#examples_144","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/workflow/#as_poly_3","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/workflow/#explanation_19","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/workflow/#as_powers_dict_3","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/workflow/#see-also_42","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/workflow/#as_real_imag_3","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/workflow/#as_set_3","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/workflow/#examples_145","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/workflow/#as_terms_3","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/workflow/#aseries_3","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/workflow/#parameters_18","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_146","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_9","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/workflow/#notes_20","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/workflow/#references_6","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/workflow/#see-also_43","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/workflow/#atoms_3","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/workflow/#examples_147","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/workflow/#cancel_3","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/workflow/#coeff_3","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/workflow/#explanation_20","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_148","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_44","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#collect_3","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/workflow/#combsimp_3","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/workflow/#compare_3","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/workflow/#examples_149","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/workflow/#compute_leading_term_3","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/workflow/#conjugate_3","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/workflow/#copy_3","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/workflow/#could_extract_minus_sign_3","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/workflow/#examples_150","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/workflow/#count_3","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/workflow/#count_ops_3","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/workflow/#diff_3","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/workflow/#dir_3","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/workflow/#doit_3","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/workflow/#dummy_eq_3","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/workflow/#examples_151","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/workflow/#equals_3","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/workflow/#explanation_21","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/workflow/#evalf_3","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/workflow/#parameters_19","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_21","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#expand_3","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/workflow/#extract_additively_3","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/workflow/#examples_152","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_45","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/workflow/#extract_branch_factor_3","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/workflow/#extract_multiplicatively_3","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/workflow/#examples_153","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/workflow/#factor_3","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/workflow/#find_3","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/workflow/#find_field_3","text":"def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference.","title":"find_field"},{"location":"reference/dewret/workflow/#fourier_series_3","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/workflow/#fps_3","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/workflow/#gammasimp_3","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/workflow/#geto_3","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/workflow/#getn_3","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/workflow/#explanation_22","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_154","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/workflow/#has_3","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/workflow/#examples_155","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/workflow/#has_free_3","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/workflow/#examples_156","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/workflow/#has_xfree_3","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/workflow/#examples_157","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/workflow/#integrate_3","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/workflow/#invert_3","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/workflow/#see-also_46","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/workflow/#is_algebraic_expr_3","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/workflow/#examples_158","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_47","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/workflow/#references_7","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/workflow/#is_constant_3","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/workflow/#explanation_23","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_159","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/workflow/#is_hypergeometric_3","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/workflow/#is_meromorphic_3","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/workflow/#examples_160","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/workflow/#is_polynomial_3","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/workflow/#examples_161","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/workflow/#is_rational_function_3","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/workflow/#examples_162","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/workflow/#is_same_3","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/workflow/#examples_163","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/workflow/#leadterm_3","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/workflow/#examples_164","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/workflow/#limit_3","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/workflow/#lseries_3","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/workflow/#match_3","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/workflow/#examples_165","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/workflow/#matches_3","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/workflow/#examples_166","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/workflow/#n_3","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/workflow/#parameters_20","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_22","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#normal_3","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/workflow/#see-also_48","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/workflow/#nseries_3","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/workflow/#examples_167","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/workflow/#nsimplify_3","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/workflow/#powsimp_3","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/workflow/#primitive_3","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/workflow/#examples_168","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/workflow/#radsimp_3","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/workflow/#ratsimp_3","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/workflow/#rcall_3","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/workflow/#refine_3","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/workflow/#removeo_3","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/workflow/#replace_3","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/workflow/#examples_169","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_49","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/workflow/#rewrite_3","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/workflow/#parameters_21","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_170","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/workflow/#round_3","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/workflow/#examples_171","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/workflow/#notes_23","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/workflow/#separate_3","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/workflow/#series_3","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/workflow/#parameters_22","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_172","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_10","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/workflow/#raises_3","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/workflow/#simplify_3","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/workflow/#sort_key_3","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/workflow/#examples_173","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/workflow/#subs_3","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/workflow/#examples_174","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_50","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/workflow/#taylor_term_3","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/workflow/#to_nnf_3","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/workflow/#together_3","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/workflow/#transpose_3","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/workflow/#trigsimp_3","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/workflow/#xreplace_3","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/workflow/#parameters_23","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/workflow/#returns_11","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/workflow/#examples_175","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_51","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/workflow/#step","text":"class Step ( workflow : 'Workflow' , task : 'Task | Workflow' , arguments : 'Mapping[str, Reference[Any] | Raw]' , raw_as_parameter : 'bool' = False ) Regular step.","title":"Step"},{"location":"reference/dewret/workflow/#ancestors-in-mro_10","text":"dewret.workflow.BaseStep dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#descendants_4","text":"dewret.workflow.FactoryCall","title":"Descendants"},{"location":"reference/dewret/workflow/#class-variables_7","text":"positional_args","title":"Class variables"},{"location":"reference/dewret/workflow/#instance-variables_8","text":"id Consistent ID based on the value. name Name for this step. May be remapped by the workflow to something nicer than the ID. return_type Take the type of the wrapped function from the target. Unwraps and inspects the signature, meaning that the original wrapped function must have a typehint for the return value.","title":"Instance variables"},{"location":"reference/dewret/workflow/#methods_8","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#make_reference_4","text":"def make_reference ( self , ** kwargs : 'Any' ) -> \"'StepReference[T]'\" Create a reference to this step. Builds a reference to the (result of) this step, which will be iterable if appropriate. Parameters: Name Type Description Default **kwargs None arguments for reference constructor, which will be supplemented appropriately. None","title":"make_reference"},{"location":"reference/dewret/workflow/#set_workflow_3","text":"def set_workflow ( self , workflow : 'Workflow' , with_arguments : 'bool' = True ) -> 'None' Move the step reference to another workflow. This method is primarily intended to be called by a step, allowing it to switch to a new workflow. It also updates the workflow reference for any arguments that are steps themselves, if specified. Parameters: Name Type Description Default workflow None The new target workflow to which the step should be moved. None with_arguments None If True, also update the workflow reference for the step's arguments. None","title":"set_workflow"},{"location":"reference/dewret/workflow/#stepreference","text":"class StepReference ( step : 'BaseStep' , * args : 'Any' , typ : 'type[U] | None' = None , ** kwargs : 'Any' ) Reference to an individual Step . Allows us to refer to the outputs of a Step in subsequent Step arguments.","title":"StepReference"},{"location":"reference/dewret/workflow/#attributes_4","text":"Name Type Description Default _ None metadata wrapping the Step referred to. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro_11","text":"dewret.workflow.FieldableMixin dewret.core.Reference typing.Generic sympy.core.symbol.Symbol sympy.core.expr.AtomicExpr sympy.core.basic.Atom sympy.core.expr.Expr sympy.logic.boolalg.Boolean sympy.core.basic.Basic sympy.printing.defaults.Printable sympy.core.evalf.EvalfMixin dewret.core.WorkflowComponent","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#descendants_5","text":"dewret.workflow.IterableStepReference","title":"Descendants"},{"location":"reference/dewret/workflow/#class-variables_8","text":"StepReferenceMetadata default_assumptions is_Add is_AlgebraicNumber is_Atom is_Boolean is_Derivative is_Dummy is_Equality is_Float is_Function is_Indexed is_Integer is_MatAdd is_MatMul is_Matrix is_Mul is_Not is_Number is_NumberSymbol is_Order is_Piecewise is_Point is_Poly is_Pow is_Rational is_Relational is_Symbol is_Vector is_Wild is_comparable is_number is_scalar is_symbol","title":"Class variables"},{"location":"reference/dewret/workflow/#static-methods_4","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#class_key_4","text":"def class_key ( ) Nice order of classes.","title":"class_key"},{"location":"reference/dewret/workflow/#fromiter_4","text":"def fromiter ( args , ** assumptions ) Create a new object from an iterable. This is a convenience function that allows one to create objects from any iterable, without having to convert to a list or tuple first.","title":"fromiter"},{"location":"reference/dewret/workflow/#examples_176","text":"from sympy import Tuple Tuple.fromiter(i for i in range(5)) (0, 1, 2, 3, 4)","title":"Examples"},{"location":"reference/dewret/workflow/#instance-variables_9","text":"args Returns a tuple of arguments of 'self'.","title":"Instance variables"},{"location":"reference/dewret/workflow/#examples_177","text":"from sympy import cot from sympy.abc import x, y cot(x).args (x,) cot(x).args[0] x (x*y).args (x, y) (x*y).args[1] y","title":"Examples"},{"location":"reference/dewret/workflow/#notes_24","text":"Never use self._args, always use self.args. Only use _args in new when creating a new function. Do not override .args() from Basic (so that it is easy to change the interface in the future if needed). assumptions0 binary_symbols canonical_variables Return a dictionary mapping any variable defined in self.bound_symbols to Symbols that do not clash with any free symbols in the expression.","title":"Notes"},{"location":"reference/dewret/workflow/#examples_178","text":"from sympy import Lambda from sympy.abc import x Lambda(x, 2*x).canonical_variables {x: _0} expr_free_symbols free_symbols func The top-level function in an expression. The following should hold for all objects:: >> x == x.func(*x.args)","title":"Examples"},{"location":"reference/dewret/workflow/#examples_179","text":"from sympy.abc import x a = 2 x a.func a.args (2, x) a.func( a.args) 2 x a == a.func( a.args) True is_algebraic is_antihermitian is_commutative is_complex is_composite is_even is_extended_negative is_extended_nonnegative is_extended_nonpositive is_extended_nonzero is_extended_positive is_extended_real is_finite is_hermitian is_imaginary is_infinite is_integer is_irrational is_negative is_noninteger is_nonnegative is_nonpositive is_nonzero is_odd is_polar is_positive is_prime is_rational is_real is_transcendental is_zero kind name Printable name of the reference.","title":"Examples"},{"location":"reference/dewret/workflow/#methods_9","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#adjoint_4","text":"def adjoint ( self )","title":"adjoint"},{"location":"reference/dewret/workflow/#apart_4","text":"def apart ( self , x = None , ** args ) See the apart function in sympy.polys","title":"apart"},{"location":"reference/dewret/workflow/#args_cnc_4","text":"def args_cnc ( self , cset = False , warn = True , split_1 = True ) Return [commutative factors, non-commutative factors] of self.","title":"args_cnc"},{"location":"reference/dewret/workflow/#explanation_24","text":"self is treated as a Mul and the ordering of the factors is maintained. If cset is True the commutative factors will be returned in a set. If there were repeated factors (as may happen with an unevaluated Mul) then an error will be raised unless it is explicitly suppressed by setting warn to False. Note: -1 is always separated from a Number unless split_1 is False.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_180","text":"from sympy import symbols, oo A, B = symbols('A B', commutative=0) x, y = symbols('x y') (-2 x y).args_cnc() [[-1, 2, x, y], []] (-2.5 x).args_cnc() [[-1, 2.5, x], []] (-2 x A B y).args_cnc() [[-1, 2, x, y], [A, B]] (-2 x A B y).args_cnc(split_1=False) [[-2, x, y], [A, B]] (-2 x*y).args_cnc(cset=True) [{-1, 2, x, y}, []] The arg is always treated as a Mul: (-2 + x + A).args_cnc() [[], [x - 2 + A]] (-oo).args_cnc() # -oo is a singleton [[-1, oo], []]","title":"Examples"},{"location":"reference/dewret/workflow/#as_base_exp_4","text":"def as_base_exp ( self ) -> 'tuple[Expr, Expr]'","title":"as_base_exp"},{"location":"reference/dewret/workflow/#as_coeff_add_8","text":"def as_coeff_Add ( self , rational = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a summation.","title":"as_coeff_Add"},{"location":"reference/dewret/workflow/#as_coeff_mul_8","text":"def as_coeff_Mul ( self , rational : 'bool' = False ) -> \"tuple['Number', Expr]\" Efficiently extract the coefficient of a product.","title":"as_coeff_Mul"},{"location":"reference/dewret/workflow/#as_coeff_add_9","text":"def as_coeff_add ( self , * deps ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as an Add, a . c should be a Rational added to any terms of the Add that are independent of deps. args should be a tuple of all other terms of a ; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is an Add or not but you want to treat self as an Add or if you want to process the individual arguments of the tail of self as an Add. if you know self is an Add and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail. if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_add() (3, ()) (3 + x).as_coeff_add() (3, (x,)) (3 + x + y).as_coeff_add(x) (y + 3, (x,)) (3 + y).as_coeff_add(x) (y + 3, ())","title":"as_coeff_add"},{"location":"reference/dewret/workflow/#as_coeff_exponent_4","text":"def as_coeff_exponent ( self , x ) -> 'tuple[Expr, Expr]' c*x**e -> c,e where x can be any symbolic expression.","title":"as_coeff_exponent"},{"location":"reference/dewret/workflow/#as_coeff_mul_9","text":"def as_coeff_mul ( self , * deps , ** kwargs ) -> 'tuple[Expr, tuple[Expr, ...]]' Return the tuple (c, args) where self is written as a Mul, m . c should be a Rational multiplied by any factors of the Mul that are independent of deps. args should be a tuple of all other factors of m; args is empty if self is a Number or if self is independent of deps (when given). This should be used when you do not know if self is a Mul or not but you want to treat self as a Mul or if you want to process the individual arguments of the tail of self as a Mul. if you know self is a Mul and want only the head, use self.args[0]; if you do not want to process the arguments of the tail but need the tail then use self.as_two_terms() which gives the head and tail; if you want to split self into an independent and dependent parts use self.as_independent(*deps) from sympy import S from sympy.abc import x, y (S(3)).as_coeff_mul() (3, ()) (3 x y).as_coeff_mul() (3, (x, y)) (3 x y).as_coeff_mul(x) (3 y, (x,)) (3 y).as_coeff_mul(x) (3*y, ())","title":"as_coeff_mul"},{"location":"reference/dewret/workflow/#as_coefficient_4","text":"def as_coefficient ( self , expr ) Extracts symbolic coefficient at the given expression. In other words, this functions separates 'self' into the product of 'expr' and 'expr'-free coefficient. If such separation is not possible it will return None.","title":"as_coefficient"},{"location":"reference/dewret/workflow/#examples_181","text":"from sympy import E, pi, sin, I, Poly from sympy.abc import x E.as_coefficient(E) 1 (2 E).as_coefficient(E) 2 (2 sin(E)*E).as_coefficient(E) Two terms have E in them so a sum is returned. (If one were desiring the coefficient of the term exactly matching E then the constant from the returned expression could be selected. Or, for greater precision, a method of Poly can be used to indicate the desired term from which the coefficient is desired.) (2 E + x E).as_coefficient(E) x + 2 _.args[0] # just want the exact match 2 p = Poly(2 E + x E); p Poly(x E + 2 E, x, E, domain='ZZ') p.coeff_monomial(E) 2 p.nth(0, 1) 2 Since the following cannot be written as a product containing E as a factor, None is returned. (If the coefficient 2*x is desired then the coeff method should be used.) (2 E x + x).as_coefficient(E) (2 E x + x).coeff(E) 2*x (E*(x + 1) + x).as_coefficient(E) (2 pi I).as_coefficient(pi I) 2 (2 I).as_coefficient(pi*I)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_52","text":"coeff: return sum of terms have a given factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#as_coefficients_dict_4","text":"def as_coefficients_dict ( self , * syms ) Return a dictionary mapping terms to their Rational coefficient. Since the dictionary is a defaultdict, inquiries about terms which were not present will return a coefficient of 0. If symbols syms are provided, any multiplicative terms independent of them will be considered a coefficient and a regular dictionary of syms-dependent generators as keys and their corresponding coefficients as values will be returned.","title":"as_coefficients_dict"},{"location":"reference/dewret/workflow/#examples_182","text":"from sympy.abc import a, x, y (3 x + a x + 4).as_coefficients_dict() {1: 4, x: 3, a x: 1} _[a] 0 (3 a x).as_coefficients_dict() {a x: 3} (3 a x).as_coefficients_dict(x) {x: 3 a} (3 a x).as_coefficients_dict(y) {1: 3 a*x}","title":"Examples"},{"location":"reference/dewret/workflow/#as_content_primitive_4","text":"def as_content_primitive ( self , radical = False , clear = True ) This method should recursively remove a Rational from all arguments and return that (content) and the new self (primitive). The content should always be positive and Mul(*foo.as_content_primitive()) == foo . The primitive need not be in canonical form and should try to preserve the underlying structure if possible (i.e. expand_mul should not be applied to self).","title":"as_content_primitive"},{"location":"reference/dewret/workflow/#examples_183","text":"from sympy import sqrt from sympy.abc import x, y, z eq = 2 + 2 x + 2 y (3 + 3 y) The as_content_primitive function is recursive and retains structure: eq.as_content_primitive() (2, x + 3 y (y + 1) + 1) Integer powers will have Rationals extracted from the base: ((2 + 6 x) 2).as_content_primitive() (4, (3 x + 1) 2) ((2 + 6*x) (2 y)).as_content_primitive() (1, (2 (3 x + 1)) (2 y)) Terms may end up joining once their as_content_primitives are added: ((5 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (11, x (y + 1)) ((3 (x (1 + y)) + 2 x (3 + 3 y))).as_content_primitive() (9, x (y + 1)) ((3 (z (1 + y)) + 2.0 x (3 + 3 y))).as_content_primitive() (1, 6.0 x (y + 1) + 3 z (y + 1)) ((5 (x (1 + y)) + 2 x (3 + 3 y)) 2).as_content_primitive() (121, x 2 (y + 1) 2) ((x (1 + y) + 0.4 x (3 + 3 y)) 2).as_content_primitive() (1, 4.84 x 2*(y + 1) 2) Radical content can also be factored out of the primitive: (2 sqrt(2) + 4 sqrt(10)).as_content_primitive(radical=True) (2, sqrt(2) (1 + 2 sqrt(5))) If clear=False (default is True) then content will not be removed from an Add if it can be distributed to leave one or more terms with integer coefficients. (x/2 + y).as_content_primitive() (1/2, x + 2*y) (x/2 + y).as_content_primitive(clear=False) (1, x/2 + y)","title":"Examples"},{"location":"reference/dewret/workflow/#as_dummy_4","text":"def as_dummy ( self ) Return the expression with any objects having structurally bound symbols replaced with unique, canonical symbols within the object in which they appear and having only the default assumption for commutativity being True. When applied to a symbol a new symbol having only the same commutativity will be returned.","title":"as_dummy"},{"location":"reference/dewret/workflow/#examples_184","text":"from sympy import Integral, Symbol from sympy.abc import x r = Symbol('r', real=True) Integral(r, (r, x)).as_dummy() Integral( 0, (_0, x)) .variables[0].is_real is None True r.as_dummy() _r","title":"Examples"},{"location":"reference/dewret/workflow/#notes_25","text":"Any object that has structurally bound variables should have a property, bound_symbols that returns those symbols appearing in the object.","title":"Notes"},{"location":"reference/dewret/workflow/#as_expr_4","text":"def as_expr ( self , * gens ) Convert a polynomial to a SymPy expression.","title":"as_expr"},{"location":"reference/dewret/workflow/#examples_185","text":"from sympy import sin from sympy.abc import x, y f = (x 2 + x*y).as_poly(x, y) f.as_expr() x 2 + x*y sin(x).as_expr() sin(x)","title":"Examples"},{"location":"reference/dewret/workflow/#as_independent_4","text":"def as_independent ( self , * deps , ** hint ) -> 'tuple[Expr, Expr]' A mostly naive separation of a Mul or Add into arguments that are not are dependent on deps. To obtain as complete a separation of variables as possible, use a separation method first, e.g.: separatevars() to change Mul, Add and Pow (including exp) into Mul .expand(mul=True) to change Add or Mul into Add .expand(log=True) to change log expr into an Add The only non-naive thing that is done here is to respect noncommutative ordering of variables and to always return (0, 0) for self of zero regardless of hints. For nonzero self , the returned tuple (i, d) has the following interpretation: i will has no variable that appears in deps d will either have terms that contain variables that are in deps, or be equal to 0 (when self is an Add) or 1 (when self is a Mul) if self is an Add then self = i + d if self is a Mul then self = i*d otherwise (self, S.One) or (S.One, self) is returned. To force the expression to be treated as an Add, use the hint as_Add=True","title":"as_independent"},{"location":"reference/dewret/workflow/#examples_186","text":"-- self is an Add from sympy import sin, cos, exp from sympy.abc import x, y, z (x + x y).as_independent(x) (0, x y + x) (x + x y).as_independent(y) (x, x y) (2 x sin(x) + y + x + z).as_independent(x) (y + z, 2 x sin(x) + x) (2 x sin(x) + y + x + z).as_independent(x, y) (z, 2 x sin(x) + x + y) -- self is a Mul (x sin(x) cos(y)).as_independent(x) (cos(y), x*sin(x)) non-commutative terms cannot always be separated out when self is a Mul from sympy import symbols n1, n2, n3 = symbols('n1 n2 n3', commutative=False) (n1 + n1 n2).as_independent(n2) (n1, n1 n2) (n2 n1 + n1 n2).as_independent(n2) (0, n1 n2 + n2 n1) (n1 n2 n3).as_independent(n1) (1, n1 n2 n3) (n1 n2 n3).as_independent(n2) (n1, n2 n3) ((x-n1) (x-y)).as_independent(x) (1, (x - y)*(x - n1)) -- self is anything else: (sin(x)).as_independent(x) (1, sin(x)) (sin(x)).as_independent(y) (sin(x), 1) exp(x+y).as_independent(x) (1, exp(x + y)) -- force self to be treated as an Add: (3 x).as_independent(x, as_Add=True) (0, 3 x) -- force self to be treated as a Mul: (3+x).as_independent(x, as_Add=False) (1, x + 3) (-3+x).as_independent(x, as_Add=False) (1, x - 3) Note how the below differs from the above in making the constant on the dep term positive. (y*(-3+x)).as_independent(x) (y, x - 3) -- use .as_independent() for true independence testing instead of .has(). The former considers only symbols in the free symbols while the latter considers all symbols from sympy import Integral I = Integral(x, (x, 1, 2)) I.has(x) True x in I.free_symbols False I.as_independent(x) == (I, 1) True (I + x).as_independent(x) == (I, x) True Note: when trying to get independent terms, a separation method might need to be used first. In this case, it is important to keep track of what you send to this routine so you know how to interpret the returned values from sympy import separatevars, log separatevars(exp(x+y)).as_independent(x) (exp(y), exp(x)) (x + x y).as_independent(y) (x, x y) separatevars(x + x y).as_independent(y) (x, y + 1) (x (1 + y)).as_independent(y) (x, y + 1) (x (1 + y)).expand(mul=True).as_independent(y) (x, x y) a, b=symbols('a b', positive=True) (log(a*b).expand(log=True)).as_independent(b) (log(a), log(b))","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_53","text":"separatevars expand_log sympy.core.add.Add.as_two_terms sympy.core.mul.Mul.as_two_terms as_coeff_mul","title":"See Also"},{"location":"reference/dewret/workflow/#as_leading_term_4","text":"def as_leading_term ( self , * symbols , logx = None , cdir = 0 ) Returns the leading (nonzero) term of the series expansion of self. The _eval_as_leading_term routines are used to do this, and they must always return a non-zero value.","title":"as_leading_term"},{"location":"reference/dewret/workflow/#examples_187","text":"from sympy.abc import x (1 + x + x 2).as_leading_term(x) 1 (1/x 2 + x + x 2).as_leading_term(x) x (-2)","title":"Examples"},{"location":"reference/dewret/workflow/#as_numer_denom_4","text":"def as_numer_denom ( self ) Return the numerator and the denominator of an expression. expression -> a/b -> a, b This is just a stub that should be defined by an object's class methods to get anything else.","title":"as_numer_denom"},{"location":"reference/dewret/workflow/#see-also_54","text":"normal: return a/b instead of (a, b)","title":"See Also"},{"location":"reference/dewret/workflow/#as_ordered_factors_4","text":"def as_ordered_factors ( self , order = None ) Return list of ordered factors (if Mul) else [self].","title":"as_ordered_factors"},{"location":"reference/dewret/workflow/#as_ordered_terms_4","text":"def as_ordered_terms ( self , order = None , data = False ) Transform an expression to an ordered list of terms.","title":"as_ordered_terms"},{"location":"reference/dewret/workflow/#examples_188","text":"from sympy import sin, cos from sympy.abc import x (sin(x) 2*cos(x) + sin(x) 2 + 1).as_ordered_terms() [sin(x) 2*cos(x), sin(x) 2, 1]","title":"Examples"},{"location":"reference/dewret/workflow/#as_poly_4","text":"def as_poly ( self , * gens , ** args ) Converts self to a polynomial or returns None .","title":"as_poly"},{"location":"reference/dewret/workflow/#explanation_25","text":"from sympy import sin from sympy.abc import x, y print((x 2 + x*y).as_poly()) Poly(x 2 + x*y, x, y, domain='ZZ') print((x 2 + x*y).as_poly(x, y)) Poly(x 2 + x*y, x, y, domain='ZZ') print((x**2 + sin(y)).as_poly(x, y)) None","title":"Explanation"},{"location":"reference/dewret/workflow/#as_powers_dict_4","text":"def as_powers_dict ( self ) Return self as a dictionary of factors with each factor being treated as a power. The keys are the bases of the factors and the values, the corresponding exponents. The resulting dictionary should be used with caution if the expression is a Mul and contains non- commutative factors since the order that they appeared will be lost in the dictionary.","title":"as_powers_dict"},{"location":"reference/dewret/workflow/#see-also_55","text":"as_ordered_factors: An alternative for noncommutative applications, returning an ordered list of factors. args_cnc: Similar to as_ordered_factors, but guarantees separation of commutative and noncommutative factors.","title":"See Also"},{"location":"reference/dewret/workflow/#as_real_imag_4","text":"def as_real_imag ( self , deep = True , ** hints ) Performs complex expansion on 'self' and returns a tuple containing collected both real and imaginary parts. This method cannot be confused with re() and im() functions, which does not perform complex expansion at evaluation. However it is possible to expand both re() and im() functions and get exactly the same results as with a single call to this function. from sympy import symbols, I x, y = symbols('x,y', real=True) (x + y*I).as_real_imag() (x, y) from sympy.abc import z, w (z + w*I).as_real_imag() (re(z) - im(w), re(w) + im(z))","title":"as_real_imag"},{"location":"reference/dewret/workflow/#as_set_4","text":"def as_set ( self ) Rewrites Boolean expression in terms of real sets.","title":"as_set"},{"location":"reference/dewret/workflow/#examples_189","text":"from sympy import Symbol, Eq, Or, And x = Symbol('x', real=True) Eq(x, 0).as_set() {0} (x > 0).as_set() Interval.open(0, oo) And(-2 < x, x < 2).as_set() Interval.open(-2, 2) Or(x < -2, 2 < x).as_set() Union(Interval.open(-oo, -2), Interval.open(2, oo))","title":"Examples"},{"location":"reference/dewret/workflow/#as_terms_4","text":"def as_terms ( self ) Transform an expression to a list of terms.","title":"as_terms"},{"location":"reference/dewret/workflow/#aseries_4","text":"def aseries ( self , x = None , n = 6 , bound = 0 , hir = False ) Asymptotic Series expansion of self. This is equivalent to self.series(x, oo, n) .","title":"aseries"},{"location":"reference/dewret/workflow/#parameters_24","text":"self : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. hir : Boolean Set this parameter to be True to produce hierarchical series. It stops the recursion at an early level and may provide nicer and more useful results. bound : Value, Integer Use the bound parameter to give limit on rewriting coefficients in its normalised form.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_190","text":"from sympy import sin, exp from sympy.abc import x e = sin(1/x + exp(-x)) - sin(1/x) e.aseries(x) (1/(24 x 4) - 1/(2 x 2) + 1 + O(x (-6), (x, oo)))*exp(-x) e.aseries(x, n=3, hir=True) -exp(-2 x) sin(1/x)/2 + exp(-x) cos(1/x) + O(exp(-3 x), (x, oo)) e = exp(exp(x)/(1 - 1/x)) e.aseries(x) exp(exp(x)/(1 - 1/x)) e.aseries(x, bound=3) # doctest: +SKIP exp(exp(x)/x 2) exp(exp(x)/x) exp(-exp(x) + exp(x)/(1 - 1/x) - exp(x)/x - exp(x)/x 2)*exp(exp(x)) For rational expressions this method may return original expression without the Order term. (1/x).aseries(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_12","text":"Expr Asymptotic series expansion of the expression.","title":"Returns"},{"location":"reference/dewret/workflow/#notes_26","text":"This algorithm is directly induced from the limit computational algorithm provided by Gruntz. It majorly uses the mrv and rewrite sub-routines. The overall idea of this algorithm is first to look for the most rapidly varying subexpression w of a given expression f and then expands f in a series in w. Then same thing is recursively done on the leading coefficient till we get constant coefficients. If the most rapidly varying subexpression of a given expression f is f itself, the algorithm tries to find a normalised representation of the mrv set and rewrites f using this normalised representation. If the expansion contains an order term, it will be either O(x ** (-n)) or O(w ** (-n)) where w belongs to the most rapidly varying expression of self .","title":"Notes"},{"location":"reference/dewret/workflow/#references_8","text":".. [1] Gruntz, Dominik. A new algorithm for computing asymptotic series. In: Proc. 1993 Int. Symp. Symbolic and Algebraic Computation. 1993. pp. 239-244. .. [2] Gruntz thesis - p90 .. [3] https://en.wikipedia.org/wiki/Asymptotic_expansion","title":"References"},{"location":"reference/dewret/workflow/#see-also_56","text":"Expr.aseries: See the docstring of this function for complete details of this wrapper.","title":"See Also"},{"location":"reference/dewret/workflow/#atoms_4","text":"def atoms ( self , * types ) Returns the atoms that form the current object. By default, only objects that are truly atomic and cannot be divided into smaller pieces are returned: symbols, numbers, and number symbols like I and pi. It is possible to request atoms of any type, however, as demonstrated below.","title":"atoms"},{"location":"reference/dewret/workflow/#examples_191","text":"from sympy import I, pi, sin from sympy.abc import x, y (1 + x + 2 sin(y + I pi)).atoms() {1, 2, I, pi, x, y} If one or more types are given, the results will contain only those types of atoms. from sympy import Number, NumberSymbol, Symbol (1 + x + 2 sin(y + I pi)).atoms(Symbol) {x, y} (1 + x + 2 sin(y + I pi)).atoms(Number) {1, 2} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol) {1, 2, pi} (1 + x + 2 sin(y + I pi)).atoms(Number, NumberSymbol, I) {1, 2, I, pi} Note that I (imaginary unit) and zoo (complex infinity) are special types of number symbols and are not part of the NumberSymbol class. The type can be given implicitly, too: (1 + x + 2 sin(y + I pi)).atoms(x) # x is a Symbol {x, y} Be careful to check your assumptions when using the implicit option since S(1).is_Integer = True but type(S(1)) is One , a special type of SymPy atom, while type(S(2)) is type Integer and will find all integers in an expression: from sympy import S (1 + x + 2 sin(y + I pi)).atoms(S(1)) {1} (1 + x + 2 sin(y + I pi)).atoms(S(2)) {1, 2} Finally, arguments to atoms() can select more than atomic atoms: any SymPy type (loaded in core/ init .py) can be listed as an argument and those types of \"atoms\" as found in scanning the arguments of the expression recursively: from sympy import Function, Mul from sympy.core.function import AppliedUndef f = Function('f') (1 + f(x) + 2 sin(y + I pi)).atoms(Function) {f(x), sin(y + I pi)} (1 + f(x) + 2 sin(y + I*pi)).atoms(AppliedUndef) {f(x)} (1 + x + 2 sin(y + I pi)).atoms(Mul) {I pi, 2 sin(y + I*pi)}","title":"Examples"},{"location":"reference/dewret/workflow/#cancel_4","text":"def cancel ( self , * gens , ** args ) See the cancel function in sympy.polys","title":"cancel"},{"location":"reference/dewret/workflow/#coeff_4","text":"def coeff ( self , x , n = 1 , right = False , _first = True ) Returns the coefficient from the term(s) containing x**n . If n is zero then all terms independent of x will be returned.","title":"coeff"},{"location":"reference/dewret/workflow/#explanation_26","text":"When x is noncommutative, the coefficient to the left (default) or right of x can be returned. The keyword 'right' is ignored when x is commutative.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_192","text":"from sympy import symbols from sympy.abc import x, y, z You can select terms that have an explicit negative in front of them: (-x + 2 y).coeff(-1) x (x - 2 y).coeff(-1) 2*y You can select terms with no Rational coefficient: (x + 2 y).coeff(1) x (3 + 2 x + 4 x *2).coeff(1) 0 You can select terms independent of x by making n=0; in this case expr.as_independent(x)[0] is returned (and 0 will be returned instead of None): (3 + 2 x + 4 x 2).coeff(x, 0) 3 eq = ((x + 1) 3).expand() + 1 eq x 3 + 3*x 2 + 3*x + 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 2] eq -= 2 [eq.coeff(x, i) for i in reversed(range(4))] [1, 3, 3, 0] You can select terms that have a numerical term in front of them: (-x - 2 y).coeff(2) -y from sympy import sqrt (x + sqrt(2) x).coeff(sqrt(2)) x The matching is exact: (3 + 2 x + 4 x 2).coeff(x) 2 (3 + 2 x + 4 x 2).coeff(x 2) 4 (3 + 2 x + 4 x 2).coeff(x 3) 0 (z*(x + y) 2).coeff((x + y) 2) z (z*(x + y) 2).coeff(x + y) 0 In addition, no factoring is done, so 1 + z*(1 + y) is not obtained from the following: (x + z (x + x y)).coeff(x) 1 If such factoring is desired, factor_terms can be used first: from sympy import factor_terms factor_terms(x + z (x + x y)).coeff(x) z*(y + 1) + 1 n, m, o = symbols('n m o', commutative=False) n.coeff(n) 1 (3 n).coeff(n) 3 (n m + m n m).coeff(n) # = (1 + m) n m 1 + m (n m + m n m).coeff(n, right=True) # = (1 + m) n*m m If there is more than one possible coefficient 0 is returned: (n m + m n).coeff(n) 0 If there is only one possible coefficient, it is returned: (n m + x m n).coeff(m n) x (n m + x m n).coeff(m n, right=1) 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_57","text":"as_coefficient: separate the expression into a coefficient and factor as_coeff_Add: separate the additive constant from an expression as_coeff_Mul: separate the multiplicative constant from an expression as_independent: separate x-dependent terms/factors from others sympy.polys.polytools.Poly.coeff_monomial: efficiently find the single coefficient of a monomial in Poly sympy.polys.polytools.Poly.nth: like coeff_monomial but powers of monomial terms are used","title":"See Also"},{"location":"reference/dewret/workflow/#collect_4","text":"def collect ( self , syms , func = None , evaluate = True , exact = False , distribute_order_term = True ) See the collect function in sympy.simplify","title":"collect"},{"location":"reference/dewret/workflow/#combsimp_4","text":"def combsimp ( self ) See the combsimp function in sympy.simplify","title":"combsimp"},{"location":"reference/dewret/workflow/#compare_4","text":"def compare ( self , other ) Return -1, 0, 1 if the object is less than, equal, or greater than other in a canonical sense. Non-Basic are always greater than Basic. If both names of the classes being compared appear in the ordering_of_classes then the ordering will depend on the appearance of the names there. If either does not appear in that list, then the comparison is based on the class name. If the names are the same then a comparison is made on the length of the hashable content. Items of the equal-lengthed contents are then successively compared using the same rules. If there is never a difference then 0 is returned.","title":"compare"},{"location":"reference/dewret/workflow/#examples_193","text":"from sympy.abc import x, y x.compare(y) -1 x.compare(x) 0 y.compare(x) 1","title":"Examples"},{"location":"reference/dewret/workflow/#compute_leading_term_4","text":"def compute_leading_term ( self , x , logx = None ) Deprecated function to compute the leading term of a series. as_leading_term is only allowed for results of .series() This is a wrapper to compute a series first.","title":"compute_leading_term"},{"location":"reference/dewret/workflow/#conjugate_4","text":"def conjugate ( self ) Returns the complex conjugate of 'self'.","title":"conjugate"},{"location":"reference/dewret/workflow/#copy_4","text":"def copy ( self )","title":"copy"},{"location":"reference/dewret/workflow/#could_extract_minus_sign_4","text":"def could_extract_minus_sign ( self ) Return True if self has -1 as a leading factor or has more literal negative signs than positive signs in a sum, otherwise False.","title":"could_extract_minus_sign"},{"location":"reference/dewret/workflow/#examples_194","text":"from sympy.abc import x, y e = x - y {i.could_extract_minus_sign() for i in (e, -e)} {False, True} Though the y - x is considered like -(x - y) , since it is in a product without a leading factor of -1, the result is false below: (x*(y - x)).could_extract_minus_sign() False To put something in canonical form wrt to sign, use signsimp : from sympy import signsimp signsimp(x (y - x)) -x (x - y) _.could_extract_minus_sign() True","title":"Examples"},{"location":"reference/dewret/workflow/#count_4","text":"def count ( self , query ) Count the number of matching subexpressions.","title":"count"},{"location":"reference/dewret/workflow/#count_ops_4","text":"def count_ops ( self , visual = None ) Wrapper for count_ops that returns the operation count.","title":"count_ops"},{"location":"reference/dewret/workflow/#diff_4","text":"def diff ( self , * symbols , ** assumptions )","title":"diff"},{"location":"reference/dewret/workflow/#dir_4","text":"def dir ( self , x , cdir )","title":"dir"},{"location":"reference/dewret/workflow/#doit_4","text":"def doit ( self , ** hints ) Evaluate objects that are not evaluated by default like limits, integrals, sums and products. All objects of this kind will be evaluated recursively, unless some species were excluded via 'hints' or unless the 'deep' hint was set to 'False'. from sympy import Integral from sympy.abc import x 2 Integral(x, x) 2 Integral(x, x) (2 Integral(x, x)).doit() x *2 (2 Integral(x, x)).doit(deep=False) 2 Integral(x, x)","title":"doit"},{"location":"reference/dewret/workflow/#dummy_eq_4","text":"def dummy_eq ( self , other , symbol = None ) Compare two expressions and handle dummy symbols.","title":"dummy_eq"},{"location":"reference/dewret/workflow/#examples_195","text":"from sympy import Dummy from sympy.abc import x, y u = Dummy('u') (u 2 + 1).dummy_eq(x 2 + 1) True (u 2 + 1) == (x 2 + 1) False (u 2 + y).dummy_eq(x 2 + y, x) True (u 2 + y).dummy_eq(x 2 + y, y) False","title":"Examples"},{"location":"reference/dewret/workflow/#equals_4","text":"def equals ( self , other , failing_expression = False ) Return True if self == other, False if it does not, or None. If failing_expression is True then the expression which did not simplify to a 0 will be returned instead of None.","title":"equals"},{"location":"reference/dewret/workflow/#explanation_27","text":"If self is a Number (or complex number) that is not zero, then the result is False. If self is a number and has not evaluated to zero, evalf will be used to test whether the expression evaluates to zero. If it does so and the result has significance (i.e. the precision is either -1, for a Rational result, or is greater than 1) then the evalf value will be used to return True or False.","title":"Explanation"},{"location":"reference/dewret/workflow/#evalf_4","text":"def evalf ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"evalf"},{"location":"reference/dewret/workflow/#parameters_25","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_27","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#expand_4","text":"def expand ( self , deep = True , modulus = None , power_base = True , power_exp = True , mul = True , log = True , multinomial = True , basic = True , ** hints ) Expand an expression using hints. See the docstring of the expand() function in sympy.core.function for more information.","title":"expand"},{"location":"reference/dewret/workflow/#extract_additively_4","text":"def extract_additively ( self , c ) Return self - c if it's possible to subtract c from self and make all matching coefficients move towards zero, else return None.","title":"extract_additively"},{"location":"reference/dewret/workflow/#examples_196","text":"from sympy.abc import x, y e = 2 x + 3 e.extract_additively(x + 1) x + 2 e.extract_additively(3 x) e.extract_additively(4) (y (x + 1)).extract_additively(x + 1) ((x + 1) (x + 2 y + 1) + 3).extract_additively(x + 1) (x + 1) (x + 2*y) + 3","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_58","text":"extract_multiplicatively coeff as_coefficient","title":"See Also"},{"location":"reference/dewret/workflow/#extract_branch_factor_4","text":"def extract_branch_factor ( self , allow_half = False ) Try to write self as exp_polar(2*pi*I*n)*z in a nice way. Return (z, n). from sympy import exp_polar, I, pi from sympy.abc import x, y exp_polar(I pi).extract_branch_factor() (exp_polar(I pi), 0) exp_polar(2 I pi).extract_branch_factor() (1, 1) exp_polar(-pi I).extract_branch_factor() (exp_polar(I pi), -1) exp_polar(3 pi I + x).extract_branch_factor() (exp_polar(x + I pi), 1) (y exp_polar(-5 pi I) exp_polar(3 pi I + 2 pi x)).extract_branch_factor() (y exp_polar(2 pi x), -1) exp_polar(-I pi/2).extract_branch_factor() (exp_polar(-I pi/2), 0) If allow_half is True, also extract exp_polar(I*pi): exp_polar(I pi).extract_branch_factor(allow_half=True) (1, 1/2) exp_polar(2 I pi).extract_branch_factor(allow_half=True) (1, 1) exp_polar(3 I pi).extract_branch_factor(allow_half=True) (1, 3/2) exp_polar(-I pi).extract_branch_factor(allow_half=True) (1, -1/2)","title":"extract_branch_factor"},{"location":"reference/dewret/workflow/#extract_multiplicatively_4","text":"def extract_multiplicatively ( self , c ) Return None if it's not possible to make self in the form c * something in a nice way, i.e. preserving the properties of arguments of self.","title":"extract_multiplicatively"},{"location":"reference/dewret/workflow/#examples_197","text":"from sympy import symbols, Rational x, y = symbols('x,y', real=True) ((x y) 3).extract_multiplicatively(x 2 * y) x y**2 ((x y) 3).extract_multiplicatively(x *4 * y) (2*x).extract_multiplicatively(2) x (2*x).extract_multiplicatively(3) (Rational(1, 2)*x).extract_multiplicatively(3) x/6","title":"Examples"},{"location":"reference/dewret/workflow/#factor_4","text":"def factor ( self , * gens , ** args ) See the factor() function in sympy.polys.polytools","title":"factor"},{"location":"reference/dewret/workflow/#find_4","text":"def find ( self , query , group = False ) Find all subexpressions matching a query.","title":"find"},{"location":"reference/dewret/workflow/#find_field_4","text":"def find_field ( self : 'FieldableProtocol' , field : 'str | int' , fallback_type : 'type | None' = None , ** init_kwargs : 'Any' ) -> 'Reference[Any]' Field within the reference, if possible. Parameters: Name Type Description Default field None the field to search for. None fallback_type None the type to use if we do not know a more specific one. None **init_kwargs None arguments to use for constructing a new reference (via __make_reference__ ). None Returns: Type Description None A field-specific version of this reference.","title":"find_field"},{"location":"reference/dewret/workflow/#fourier_series_4","text":"def fourier_series ( self , limits = None ) Compute fourier sine/cosine series of self. See the docstring of the :func: fourier_series in sympy.series.fourier for more information.","title":"fourier_series"},{"location":"reference/dewret/workflow/#fps_4","text":"def fps ( self , x = None , x0 = 0 , dir = 1 , hyper = True , order = 4 , rational = True , full = False ) Compute formal power power series of self. See the docstring of the :func: fps function in sympy.series.formal for more information.","title":"fps"},{"location":"reference/dewret/workflow/#gammasimp_4","text":"def gammasimp ( self ) See the gammasimp function in sympy.simplify","title":"gammasimp"},{"location":"reference/dewret/workflow/#geto_4","text":"def getO ( self ) Returns the additive O(..) symbol if there is one, else None.","title":"getO"},{"location":"reference/dewret/workflow/#getn_4","text":"def getn ( self ) Returns the order of the expression.","title":"getn"},{"location":"reference/dewret/workflow/#explanation_28","text":"The order is determined either from the O(...) term. If there is no O(...) term, it returns None.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_198","text":"from sympy import O from sympy.abc import x (1 + x + O(x**2)).getn() 2 (1 + x).getn()","title":"Examples"},{"location":"reference/dewret/workflow/#has_4","text":"def has ( self , * patterns ) Test whether any subexpression matches any of the patterns.","title":"has"},{"location":"reference/dewret/workflow/#examples_199","text":"from sympy import sin from sympy.abc import x, y, z (x 2 + sin(x*y)).has(z) False (x 2 + sin(x*y)).has(x, y, z) True x.has(x) True Note has is a structural algorithm with no knowledge of mathematics. Consider the following half-open interval: from sympy import Interval i = Interval.Lopen(0, 5); i Interval.Lopen(0, 5) i.args (0, 5, True, False) i.has(4) # there is no \"4\" in the arguments False i.has(0) # there is a \"0\" in the arguments True Instead, use contains to determine whether a number is in the interval or not: i.contains(4) True i.contains(0) False Note that expr.has(*patterns) is exactly equivalent to any(expr.has(p) for p in patterns) . In particular, False is returned when the list of patterns is empty. x.has() False","title":"Examples"},{"location":"reference/dewret/workflow/#has_free_4","text":"def has_free ( self , * patterns ) Return True if self has object(s) x as a free expression else False.","title":"has_free"},{"location":"reference/dewret/workflow/#examples_200","text":"from sympy import Integral, Function from sympy.abc import x, y f = Function('f') g = Function('g') expr = Integral(f(x), (f(x), 1, g(y))) expr.free_symbols {y} expr.has_free(g(y)) True expr.has_free(*(x, f(x))) False This works for subexpressions and types, too: expr.has_free(g) True (x + y + 1).has_free(y + 1) True","title":"Examples"},{"location":"reference/dewret/workflow/#has_xfree_4","text":"def has_xfree ( self , s : 'set[Basic]' ) Return True if self has any of the patterns in s as a free argument, else False. This is like Basic.has_free but this will only report exact argument matches.","title":"has_xfree"},{"location":"reference/dewret/workflow/#examples_201","text":"from sympy import Function from sympy.abc import x, y f = Function('f') f(x).has_xfree({f}) False f(x).has_xfree({f(x)}) True f(x + 1).has_xfree({x}) True f(x + 1).has_xfree({x + 1}) True f(x + y + 1).has_xfree({x + 1}) False","title":"Examples"},{"location":"reference/dewret/workflow/#integrate_4","text":"def integrate ( self , * args , ** kwargs ) See the integrate function in sympy.integrals","title":"integrate"},{"location":"reference/dewret/workflow/#invert_4","text":"def invert ( self , g , * gens , ** args ) Return the multiplicative inverse of self mod g where self (and g ) may be symbolic expressions).","title":"invert"},{"location":"reference/dewret/workflow/#see-also_59","text":"sympy.core.intfunc.mod_inverse, sympy.polys.polytools.invert","title":"See Also"},{"location":"reference/dewret/workflow/#is_algebraic_expr_4","text":"def is_algebraic_expr ( self , * syms ) This tests whether a given expression is algebraic or not, in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"algebraic expressions\" with symbolic exponents. This is a simple extension to the is_rational_function, including rational exponentiation.","title":"is_algebraic_expr"},{"location":"reference/dewret/workflow/#examples_202","text":"from sympy import Symbol, sqrt x = Symbol('x', real=True) sqrt(1 + x).is_rational_function() False sqrt(1 + x).is_algebraic_expr() True This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be an algebraic expression to become one. from sympy import exp, factor a = sqrt(exp(x)* 2 + 2 exp(x) + 1)/(exp(x) + 1) a.is_algebraic_expr(x) False factor(a).is_algebraic_expr() True","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_60","text":"is_rational_function","title":"See Also"},{"location":"reference/dewret/workflow/#references_9","text":".. [1] https://en.wikipedia.org/wiki/Algebraic_expression","title":"References"},{"location":"reference/dewret/workflow/#is_constant_4","text":"def is_constant ( self , * wrt , ** flags ) Return True if self is constant, False if not, or None if the constancy could not be determined conclusively.","title":"is_constant"},{"location":"reference/dewret/workflow/#explanation_29","text":"If an expression has no free symbols then it is a constant. If there are free symbols it is possible that the expression is a constant, perhaps (but not necessarily) zero. To test such expressions, a few strategies are tried: 1) numerical evaluation at two random points. If two such evaluations give two different values and the values have a precision greater than 1 then self is not constant. If the evaluations agree or could not be obtained with any precision, no decision is made. The numerical testing is done only if wrt is different than the free symbols. 2) differentiation with respect to variables in 'wrt' (or all free symbols if omitted) to see if the expression is constant or not. This will not always lead to an expression that is zero even though an expression is constant (see added test in test_expr.py). If all derivatives are zero then self is constant with respect to the given symbols. 3) finding out zeros of denominator expression with free_symbols. It will not be constant if there are zeros. It gives more negative answers for expression that are not constant. If neither evaluation nor differentiation can prove the expression is constant, None is returned unless two numerical values happened to be the same and the flag failing_number is True -- in that case the numerical value will be returned. If flag simplify=False is passed, self will not be simplified; the default is True since self should be simplified before testing.","title":"Explanation"},{"location":"reference/dewret/workflow/#examples_203","text":"from sympy import cos, sin, Sum, S, pi from sympy.abc import a, n, x, y x.is_constant() False S(2).is_constant() True Sum(x, (x, 1, 10)).is_constant() True Sum(x, (x, 1, n)).is_constant() False Sum(x, (x, 1, n)).is_constant(y) True Sum(x, (x, 1, n)).is_constant(n) False Sum(x, (x, 1, n)).is_constant(x) True eq = a cos(x) 2 + a sin(x)**2 - a eq.is_constant() True eq.subs({x: pi, a: 2}) == eq.subs({x: pi, a: 3}) == 0 True (0 x).is_constant() False x.is_constant() False (x x).is_constant() False one = cos(x) 2 + sin(x) 2 one.is_constant() True ((one - 1)**(x + 1)).is_constant() in (True, False) # could be 0 or 1 True","title":"Examples"},{"location":"reference/dewret/workflow/#is_hypergeometric_4","text":"def is_hypergeometric ( self , k )","title":"is_hypergeometric"},{"location":"reference/dewret/workflow/#is_meromorphic_4","text":"def is_meromorphic ( self , x , a ) This tests whether an expression is meromorphic as a function of the given symbol x at the point a . This method is intended as a quick test that will return None if no decision can be made without simplification or more detailed analysis.","title":"is_meromorphic"},{"location":"reference/dewret/workflow/#examples_204","text":"from sympy import zoo, log, sin, sqrt from sympy.abc import x f = 1/x 2 + 1 - 2*x 3 f.is_meromorphic(x, 0) True f.is_meromorphic(x, 1) True f.is_meromorphic(x, zoo) True g = x**log(3) g.is_meromorphic(x, 0) False g.is_meromorphic(x, 1) True g.is_meromorphic(x, zoo) False h = sin(1/x) x *2 h.is_meromorphic(x, 0) False h.is_meromorphic(x, 1) True h.is_meromorphic(x, zoo) True Multivalued functions are considered meromorphic when their branches are meromorphic. Thus most functions are meromorphic everywhere except at essential singularities and branch points. In particular, they will be meromorphic also on branch cuts except at their endpoints. log(x).is_meromorphic(x, -1) True log(x).is_meromorphic(x, 0) False sqrt(x).is_meromorphic(x, -1) True sqrt(x).is_meromorphic(x, 0) False","title":"Examples"},{"location":"reference/dewret/workflow/#is_polynomial_4","text":"def is_polynomial ( self , * syms ) Return True if self is a polynomial in syms and False otherwise. This checks if self is an exact polynomial in syms. This function returns False for expressions that are \"polynomials\" with symbolic exponents. Thus, you should be able to apply polynomial algorithms to expressions for which this returns True, and Poly(expr, *syms) should work if and only if expr.is_polynomial(*syms) returns True. The polynomial does not have to be in expanded form. If no symbols are given, all free symbols in the expression will be used. This is not part of the assumptions system. You cannot do Symbol('z', polynomial=True).","title":"is_polynomial"},{"location":"reference/dewret/workflow/#examples_205","text":"from sympy import Symbol, Function x = Symbol('x') ((x 2 + 1) 4).is_polynomial(x) True ((x 2 + 1) 4).is_polynomial() True (2 x + 1).is_polynomial(x) False (2 x + 1).is_polynomial(2**x) True f = Function('f') (f(x) + 1).is_polynomial(x) False (f(x) + 1).is_polynomial(f(x)) True (1/f(x) + 1).is_polynomial(f(x)) False n = Symbol('n', nonnegative=True, integer=True) (x**n + 1).is_polynomial(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a polynomial to become one. from sympy import sqrt, factor, cancel y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1) a.is_polynomial(y) False factor(a) y + 1 factor(a).is_polynomial(y) True b = (y* 2 + 2 y + 1)/(y + 1) b.is_polynomial(y) False cancel(b) y + 1 cancel(b).is_polynomial(y) True See also .is_rational_function()","title":"Examples"},{"location":"reference/dewret/workflow/#is_rational_function_4","text":"def is_rational_function ( self , * syms ) Test whether function is a ratio of two polynomials in the given symbols, syms. When syms is not given, all free symbols will be used. The rational function does not have to be in expanded or in any kind of canonical form. This function returns False for expressions that are \"rational functions\" with symbolic exponents. Thus, you should be able to call .as_numer_denom() and apply polynomial algorithms to the result for expressions for which this returns True. This is not part of the assumptions system. You cannot do Symbol('z', rational_function=True).","title":"is_rational_function"},{"location":"reference/dewret/workflow/#examples_206","text":"from sympy import Symbol, sin from sympy.abc import x, y (x/y).is_rational_function() True (x**2).is_rational_function() True (x/sin(y)).is_rational_function(y) False n = Symbol('n', integer=True) (x**n + 1).is_rational_function(x) False This function does not attempt any nontrivial simplifications that may result in an expression that does not appear to be a rational function to become one. from sympy import sqrt, factor y = Symbol('y', positive=True) a = sqrt(y* 2 + 2 y + 1)/y a.is_rational_function(y) False factor(a) (y + 1)/y factor(a).is_rational_function(y) True See also is_algebraic_expr().","title":"Examples"},{"location":"reference/dewret/workflow/#is_same_4","text":"def is_same ( a , b , approx = None ) Return True if a and b are structurally the same, else False. If approx is supplied, it will be used to test whether two numbers are the same or not. By default, only numbers of the same type will compare equal, so S.Half != Float(0.5).","title":"is_same"},{"location":"reference/dewret/workflow/#examples_207","text":"In SymPy (unlike Python) two numbers do not compare the same if they are not of the same type: from sympy import S 2.0 == S(2) False 0.5 == S.Half False By supplying a function with which to compare two numbers, such differences can be ignored. e.g. equal_valued will return True for decimal numbers having a denominator that is a power of 2, regardless of precision. from sympy import Float from sympy.core.numbers import equal_valued (S.Half/4).is_same(Float(0.125, 1), equal_valued) True Float(1, 2).is_same(Float(1, 10), equal_valued) True But decimals without a power of 2 denominator will compare as not being the same. Float(0.1, 9).is_same(Float(0.1, 10), equal_valued) False But arbitrary differences can be ignored by supplying a function to test the equivalence of two numbers: import math Float(0.1, 9).is_same(Float(0.1, 10), math.isclose) True Other objects might compare the same even though types are not the same. This routine will only return True if two expressions are identical in terms of class types. from sympy import eye, Basic eye(1) == S(eye(1)) # mutable vs immutable True Basic.is_same(eye(1), S(eye(1))) False","title":"Examples"},{"location":"reference/dewret/workflow/#leadterm_4","text":"def leadterm ( self , x , logx = None , cdir = 0 ) Returns the leading term a x *b as a tuple (a, b).","title":"leadterm"},{"location":"reference/dewret/workflow/#examples_208","text":"from sympy.abc import x (1+x+x 2).leadterm(x) (1, 0) (1/x 2+x+x**2).leadterm(x) (1, -2)","title":"Examples"},{"location":"reference/dewret/workflow/#limit_4","text":"def limit ( self , x , xlim , dir = '+' ) Compute limit x->xlim.","title":"limit"},{"location":"reference/dewret/workflow/#lseries_4","text":"def lseries ( self , x = None , x0 = 0 , dir = '+' , logx = None , cdir = 0 ) Wrapper for series yielding an iterator of the terms of the series. Note: an infinite series will yield an infinite iterator. The following, for exaxmple, will never terminate. It will just keep printing terms of the sin(x) series:: for term in sin(x).lseries(x): print term The advantage of lseries() over nseries() is that many times you are just interested in the next term in the series (i.e. the first term for example), but you do not know how many you should ask for in nseries() using the \"n\" parameter. See also nseries().","title":"lseries"},{"location":"reference/dewret/workflow/#match_4","text":"def match ( self , pattern , old = False ) Pattern matching. Wild symbols match all. Return None when expression (self) does not match with pattern. Otherwise return a dictionary such that:: pattern.xreplace(self.match(pattern)) == self","title":"match"},{"location":"reference/dewret/workflow/#examples_209","text":"from sympy import Wild, Sum from sympy.abc import x, y p = Wild(\"p\") q = Wild(\"q\") r = Wild(\"r\") e = (x+y) (x+y) e.match(p p) {p_: x + y} e.match(p q) {p_: x + y, q_: x + y} e = (2*x) 2 e.match(p q r) {p_: 4, q_: x, r_: 2} (p q r).xreplace(e.match(p*q r)) 4 x *2 Structurally bound symbols are ignored during matching: Sum(x, (x, 1, 2)).match(Sum(y, (y, 1, p))) {p_: 2} But they can be identified if desired: Sum(x, (x, 1, 2)).match(Sum(q, (q, 1, p))) {p_: 2, q_: x} The old flag will give the old-style pattern matching where expressions and patterns are essentially solved to give the match. Both of the following give None unless old=True : (x - 2).match(p - x, old=True) {p_: 2 x - 2} (2/x).match(p x, old=True) {p_: 2/x**2}","title":"Examples"},{"location":"reference/dewret/workflow/#matches_4","text":"def matches ( self , expr , repl_dict = None , old = False ) Helper method for match() that looks for a match between Wild symbols in self and expressions in expr.","title":"matches"},{"location":"reference/dewret/workflow/#examples_210","text":"from sympy import symbols, Wild, Basic a, b, c = symbols('a b c') x = Wild('x') Basic(a + x, x).matches(Basic(a + b, c)) is None True Basic(a + x, x).matches(Basic(a + b + c, b + c)) {x_: b + c}","title":"Examples"},{"location":"reference/dewret/workflow/#n_4","text":"def n ( self , n = 15 , subs = None , maxn = 100 , chop = False , strict = False , quad = None , verbose = False ) Evaluate the given formula to an accuracy of n digits.","title":"n"},{"location":"reference/dewret/workflow/#parameters_26","text":"subs : dict, optional Substitute numerical values for symbols, e.g. subs={x:3, y:1+pi} . The substitutions must be given as a dictionary. maxn : int, optional Allow a maximum temporary working precision of maxn digits. chop : bool or number, optional Specifies how to replace tiny real or imaginary parts in subresults by exact zeros. When ``True`` the chop value defaults to standard precision. Otherwise the chop value is used to determine the magnitude of \"small\" for purposes of chopping. >>> from sympy import N >>> x = 1e-4 >>> N(x, chop=True) 0.000100000000000000 >>> N(x, chop=1e-5) 0.000100000000000000 >>> N(x, chop=1e-4) 0 strict : bool, optional Raise PrecisionExhausted if any subresult fails to evaluate to full accuracy, given the available maxprec. quad : str, optional Choose algorithm for numerical quadrature. By default, tanh-sinh quadrature is used. For oscillatory integrals on an infinite interval, try quad='osc' . verbose : bool, optional Print debug information.","title":"Parameters"},{"location":"reference/dewret/workflow/#notes_28","text":"When Floats are naively substituted into an expression, precision errors may adversely affect the result. For example, adding 1e16 (a Float) to 1 will truncate to 1e16; if 1e16 is then subtracted, the result will be 0. That is exactly what happens in the following: from sympy.abc import x, y, z values = {x: 1e16, y: 1, z: 1e16} (x + y - z).subs(values) 0 Using the subs argument for evalf is the accurate way to evaluate such an expression: (x + y - z).evalf(subs=values) 1.00000000000000","title":"Notes"},{"location":"reference/dewret/workflow/#normal_4","text":"def normal ( self ) Return the expression as a fraction. expression -> a/b","title":"normal"},{"location":"reference/dewret/workflow/#see-also_61","text":"as_numer_denom: return (a, b) instead of a/b","title":"See Also"},{"location":"reference/dewret/workflow/#nseries_4","text":"def nseries ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Wrapper to _eval_nseries if assumptions allow, else to series. If x is given, x0 is 0, dir='+', and self has x, then _eval_nseries is called. This calculates \"n\" terms in the innermost expressions and then builds up the final series just by \"cross-multiplying\" everything out. The optional logx parameter can be used to replace any log(x) in the returned series with a symbolic value to avoid evaluating log(x) at 0. A symbol to use in place of log(x) should be provided. Advantage -- it's fast, because we do not have to determine how many terms we need to calculate in advance. Disadvantage -- you may end up with less terms than you may have expected, but the O(x**n) term appended will always be correct and so the result, though perhaps shorter, will also be correct. If any of those assumptions is not met, this is treated like a wrapper to series which will try harder to return the correct number of terms. See also lseries().","title":"nseries"},{"location":"reference/dewret/workflow/#examples_211","text":"from sympy import sin, log, Symbol from sympy.abc import x, y sin(x).nseries(x, 0, 6) x - x 3/6 + x 5/120 + O(x 6) log(x+1).nseries(x, 0, 5) x - x 2/2 + x 3/3 - x 4/4 + O(x**5) Handling of the logx parameter --- in the following example the expansion fails since sin does not have an asymptotic expansion at -oo (the limit of log(x) as x approaches 0): e = sin(log(x)) e.nseries(x, 0, 6) Traceback (most recent call last): ... PoleError: ... ... logx = Symbol('logx') e.nseries(x, 0, 6, logx=logx) sin(logx) In the following example, the expansion works but only returns self unless the logx parameter is used: e = x y e.nseries(x, 0, 2) x y e.nseries(x, 0, 2, logx=logx) exp(logx*y)","title":"Examples"},{"location":"reference/dewret/workflow/#nsimplify_4","text":"def nsimplify ( self , constants = (), tolerance = None , full = False ) See the nsimplify function in sympy.simplify","title":"nsimplify"},{"location":"reference/dewret/workflow/#powsimp_4","text":"def powsimp ( self , * args , ** kwargs ) See the powsimp function in sympy.simplify","title":"powsimp"},{"location":"reference/dewret/workflow/#primitive_4","text":"def primitive ( self ) Return the positive Rational that can be extracted non-recursively from every term of self (i.e., self is treated like an Add). This is like the as_coeff_Mul() method but primitive always extracts a positive Rational (never a negative or a Float).","title":"primitive"},{"location":"reference/dewret/workflow/#examples_212","text":"from sympy.abc import x (3 (x + 1) 2).primitive() (3, (x + 1) 2) a = (6 x + 2); a.primitive() (2, 3 x + 1) b = (x/2 + 3); b.primitive() (1/2, x + 6) (a b).primitive() == (1, a*b) True","title":"Examples"},{"location":"reference/dewret/workflow/#radsimp_4","text":"def radsimp ( self , ** kwargs ) See the radsimp function in sympy.simplify","title":"radsimp"},{"location":"reference/dewret/workflow/#ratsimp_4","text":"def ratsimp ( self ) See the ratsimp function in sympy.simplify","title":"ratsimp"},{"location":"reference/dewret/workflow/#rcall_4","text":"def rcall ( self , * args ) Apply on the argument recursively through the expression tree. This method is used to simulate a common abuse of notation for operators. For instance, in SymPy the following will not work: (x+Lambda(y, 2*y))(z) == x+2*z , however, you can use: from sympy import Lambda from sympy.abc import x, y, z (x + Lambda(y, 2 y)).rcall(z) x + 2 z","title":"rcall"},{"location":"reference/dewret/workflow/#refine_4","text":"def refine ( self , assumption = True ) See the refine function in sympy.assumptions","title":"refine"},{"location":"reference/dewret/workflow/#removeo_4","text":"def removeO ( self ) Removes the additive O(..) symbol if there is one","title":"removeO"},{"location":"reference/dewret/workflow/#replace_4","text":"def replace ( self , query , value , map = False , simultaneous = True , exact = None ) Replace matching subexpressions of self with value . If map = True then also return the mapping {old: new} where old was a sub-expression found with query and new is the replacement value for it. If the expression itself does not match the query, then the returned value will be self.xreplace(map) otherwise it should be self.subs(ordered(map.items())) . Traverses an expression tree and performs replacement of matching subexpressions from the bottom to the top of the tree. The default approach is to do the replacement in a simultaneous fashion so changes made are targeted only once. If this is not desired or causes problems, simultaneous can be set to False. In addition, if an expression containing more than one Wild symbol is being used to match subexpressions and the exact flag is None it will be set to True so the match will only succeed if all non-zero values are received for each Wild that appears in the match pattern. Setting this to False accepts a match of 0; while setting it True accepts all matches that have a 0 in them. See example below for cautions. The list of possible combinations of queries and replacement values is listed below:","title":"replace"},{"location":"reference/dewret/workflow/#examples_213","text":"Initial setup from sympy import log, sin, cos, tan, Wild, Mul, Add from sympy.abc import x, y f = log(sin(x)) + tan(sin(x**2)) 1.1. type -> type obj.replace(type, newtype) When object of type ``type`` is found, replace it with the result of passing its argument(s) to ``newtype``. >>> f.replace(sin, cos) log(cos(x)) + tan(cos(x**2)) >>> sin(x).replace(sin, cos, map=True) (cos(x), {sin(x): cos(x)}) >>> (x*y).replace(Mul, Add) x + y 1.2. type -> func obj.replace(type, func) When object of type ``type`` is found, apply ``func`` to its argument(s). ``func`` must be written to handle the number of arguments of ``type``. >>> f.replace(sin, lambda arg: sin(2*arg)) log(sin(2*x)) + tan(sin(2*x**2)) >>> (x*y).replace(Mul, lambda *args: sin(2*Mul(*args))) sin(2*x*y) 2.1. pattern -> expr obj.replace(pattern(wild), expr(wild)) Replace subexpressions matching ``pattern`` with the expression written in terms of the Wild symbols in ``pattern``. >>> a, b = map(Wild, 'ab') >>> f.replace(sin(a), tan(a)) log(tan(x)) + tan(tan(x**2)) >>> f.replace(sin(a), tan(a/2)) log(tan(x/2)) + tan(tan(x**2/2)) >>> f.replace(sin(a), a) log(x) + tan(x**2) >>> (x*y).replace(a*x, a) y Matching is exact by default when more than one Wild symbol is used: matching fails unless the match gives non-zero values for all Wild symbols: >>> (2*x + y).replace(a*x + b, b - a) y - 2 >>> (2*x).replace(a*x + b, b - a) 2*x When set to False, the results may be non-intuitive: >>> (2*x).replace(a*x + b, b - a, exact=False) 2/x 2.2. pattern -> func obj.replace(pattern(wild), lambda wild: expr(wild)) All behavior is the same as in 2.1 but now a function in terms of pattern variables is used rather than an expression: >>> f.replace(sin(a), lambda a: sin(2*a)) log(sin(2*x)) + tan(sin(2*x**2)) 3.1. func -> func obj.replace(filter, func) Replace subexpression ``e`` with ``func(e)`` if ``filter(e)`` is True. >>> g = 2*sin(x**3) >>> g.replace(lambda expr: expr.is_Number, lambda expr: expr**2) 4*sin(x**9) The expression itself is also targeted by the query but is done in such a fashion that changes are not made twice. >>> e = x*(x*y + 1) >>> e.replace(lambda x: x.is_Mul, lambda x: 2*x) 2*x*(2*x*y + 1) When matching a single symbol, exact will default to True, but this may or may not be the behavior that is desired: Here, we want exact=False : from sympy import Function f = Function('f') e = f(1) + f(0) q = f(a), lambda a: f(a + 1) e.replace( q, exact=False) f(1) + f(2) e.replace( q, exact=True) f(0) + f(2) But here, the nature of matching makes selecting the right setting tricky: e = x (1 + y) (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=False) x (x (1 + y)).replace(x (1 + a), lambda a: x -a, exact=True) x (-x - y + 1) (x y).replace(x (1 + a), lambda a: x -a, exact=False) x (x y).replace(x (1 + a), lambda a: x -a, exact=True) x**(1 - y) It is probably better to use a different form of the query that describes the target expression more precisely: (1 + x (1 + y)).replace( ... lambda x: x.is_Pow and x.exp.is_Add and x.exp.args[0] == 1, ... lambda x: x.base (1 - (x.exp - 1))) ... x**(1 - y) + 1","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_62","text":"subs: substitution of subexpressions as defined by the objects themselves. xreplace: exact node replacement in expr tree; also capable of using matching rules","title":"See Also"},{"location":"reference/dewret/workflow/#rewrite_4","text":"def rewrite ( self , * args , deep = True , ** hints ) Rewrite self using a defined rule. Rewriting transforms an expression to another, which is mathematically equivalent but structurally different. For example you can rewrite trigonometric functions as complex exponentials or combinatorial functions as gamma function. This method takes a pattern and a rule as positional arguments. pattern is optional parameter which defines the types of expressions that will be transformed. If it is not passed, all possible expressions will be rewritten. rule defines how the expression will be rewritten.","title":"rewrite"},{"location":"reference/dewret/workflow/#parameters_27","text":"args : Expr A rule , or pattern and rule . - pattern is a type or an iterable of types. - rule can be any object. deep : bool, optional If True , subexpressions are recursively transformed. Default is True .","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_214","text":"If pattern is unspecified, all possible expressions are transformed. from sympy import cos, sin, exp, I from sympy.abc import x expr = cos(x) + I sin(x) expr.rewrite(exp) exp(I x) Pattern can be a type or an iterable of types. expr.rewrite(sin, exp) exp(I x)/2 + cos(x) - exp(-I x)/2 expr.rewrite([cos,], exp) exp(I x)/2 + I sin(x) + exp(-I x)/2 expr.rewrite([cos, sin], exp) exp(I x) Rewriting behavior can be implemented by defining _eval_rewrite() method. from sympy import Expr, sqrt, pi class MySin(Expr): ... def _eval_rewrite(self, rule, args, hints): ... x, = args ... if rule == cos: ... return cos(pi/2 - x, evaluate=False) ... if rule == sqrt: ... return sqrt(1 - cos(x) 2) MySin(MySin(x)).rewrite(cos) cos(-cos(-x + pi/2) + pi/2) MySin(x).rewrite(sqrt) sqrt(1 - cos(x)**2) Defining _eval_rewrite_as_[...]() method is supported for backwards compatibility reason. This may be removed in the future and using it is discouraged. class MySin(Expr): ... def _eval_rewrite_as_cos(self, args, *hints): ... x, = args ... return cos(pi/2 - x, evaluate=False) MySin(x).rewrite(cos) cos(-x + pi/2)","title":"Examples"},{"location":"reference/dewret/workflow/#round_4","text":"def round ( self , n = None ) Return x rounded to the given decimal place. If a complex number would results, apply round to the real and imaginary components of the number.","title":"round"},{"location":"reference/dewret/workflow/#examples_215","text":"from sympy import pi, E, I, S, Number pi.round() 3 pi.round(2) 3.14 (2 pi + E I).round() 6 + 3*I The round method has a chopping effect: (2 pi + I/10).round() 6 (pi/10 + 2 I).round() 2 I (pi/10 + E I).round(2) 0.31 + 2.72*I","title":"Examples"},{"location":"reference/dewret/workflow/#notes_29","text":"The Python round function uses the SymPy round method so it will always return a SymPy number (not a Python float or int): isinstance(round(S(123), -2), Number) True","title":"Notes"},{"location":"reference/dewret/workflow/#separate_4","text":"def separate ( self , deep = False , force = False ) See the separate function in sympy.simplify","title":"separate"},{"location":"reference/dewret/workflow/#series_4","text":"def series ( self , x = None , x0 = 0 , n = 6 , dir = '+' , logx = None , cdir = 0 ) Series expansion of \"self\" around x = x0 yielding either terms of the series one by one (the lazy series given when n=None), else all the terms at once when n != None. Returns the series expansion of \"self\" around the point x = x0 with respect to x up to O((x - x0)**n, x, x0) (default n is 6). If x=None and self is univariate, the univariate symbol will be supplied, otherwise an error will be raised.","title":"series"},{"location":"reference/dewret/workflow/#parameters_28","text":"expr : Expression The expression whose series is to be expanded. x : Symbol It is the variable of the expression to be calculated. x0 : Value The value around which x is calculated. Can be any value from -oo to oo . n : Value The value used to represent the order in terms of x**n , up to which the series is to be expanded. dir : String, optional The series-expansion can be bi-directional. If dir=\"+\" , then (x->x0+). If dir=\"-\", then (x->x0-). For infinite x0 ( oo or -oo ), the dir argument is determined from the direction of the infinity (i.e., dir=\"-\" for oo``). logx : optional It is used to replace any log(x) in the returned series with a symbolic value rather than evaluating the actual value. cdir : optional It stands for complex direction, and indicates the direction from which the expansion needs to be evaluated.","title":"Parameters"},{"location":"reference/dewret/workflow/#examples_216","text":"from sympy import cos, exp, tan from sympy.abc import x, y cos(x).series() 1 - x 2/2 + x 4/24 + O(x 6) cos(x).series(n=4) 1 - x 2/2 + O(x 4) cos(x).series(x, x0=1, n=2) cos(1) - (x - 1)*sin(1) + O((x - 1) 2, (x, 1)) e = cos(x + exp(y)) e.series(y, n=2) cos(x + 1) - y sin(x + 1) + O(y 2) e.series(x, n=2) cos(exp(y)) - x sin(exp(y)) + O(x**2) If n=None then a generator of the series terms will be returned. term=cos(x).series(n=None) [next(term) for i in range(2)] [1, -x**2/2] For dir=+ (default) the series is calculated from the right and for dir=- the series from the left. For smooth functions this flag will not alter the results. abs(x).series(dir=\"+\") x abs(x).series(dir=\"-\") -x f = tan(x) f.series(x, 2, 6, \"+\") tan(2) + (1 + tan(2) 2)*(x - 2) + (x - 2) 2 (tan(2) 3 + tan(2)) + (x - 2) 3 (1/3 + 4 tan(2) 2/3 + tan(2) 4) + (x - 2) 4 (tan(2) 5 + 5*tan(2) 3/3 + 2 tan(2)/3) + (x - 2) 5 (2/15 + 17 tan(2) 2/15 + 2 tan(2) 4 + tan(2) 6) + O((x - 2)**6, (x, 2)) f.series(x, 2, 3, \"-\") tan(2) + (2 - x) (-tan(2) 2 - 1) + (2 - x) 2 (tan(2) 3 + tan(2)) + O((x - 2) 3, (x, 2)) For rational expressions this method may return original expression without the Order term. (1/x).series(x, n=8) 1/x","title":"Examples"},{"location":"reference/dewret/workflow/#returns_13","text":"Expr : Expression Series expansion of the expression about x0","title":"Returns"},{"location":"reference/dewret/workflow/#raises_4","text":"TypeError If \"n\" and \"x0\" are infinity objects PoleError If \"x0\" is an infinity object","title":"Raises"},{"location":"reference/dewret/workflow/#simplify_4","text":"def simplify ( self , ** kwargs ) See the simplify function in sympy.simplify","title":"simplify"},{"location":"reference/dewret/workflow/#sort_key_4","text":"def sort_key ( self , order = None ) Return a sort key.","title":"sort_key"},{"location":"reference/dewret/workflow/#examples_217","text":"from sympy import S, I sorted([S(1)/2, I, -I], key=lambda x: x.sort_key()) [1/2, -I, I] S(\"[x, 1/x, 1/x 2, x 2, x (1/2), x (1/4), x (3/2)]\") [x, 1/x, x (-2), x 2, sqrt(x), x (1/4), x (3/2)] sorted(_, key=lambda x: x.sort_key()) [x (-2), 1/x, x (1/4), sqrt(x), x, x (3/2), x**2]","title":"Examples"},{"location":"reference/dewret/workflow/#subs_4","text":"def subs ( self , * args , ** kwargs ) Substitutes old for new in an expression after sympifying args. args is either: - two arguments, e.g. foo.subs(old, new) - one iterable argument, e.g. foo.subs(iterable). The iterable may be o an iterable container with (old, new) pairs. In this case the replacements are processed in the order given with successive patterns possibly affecting replacements already made. o a dict or set whose key/value items correspond to old/new pairs. In this case the old/new pairs will be sorted by op count and in case of a tie, by number of args and the default_sort_key. The resulting sorted list is then processed as an iterable container (see previous). If the keyword simultaneous is True, the subexpressions will not be evaluated until all the substitutions have been made.","title":"subs"},{"location":"reference/dewret/workflow/#examples_218","text":"from sympy import pi, exp, limit, oo from sympy.abc import x, y (1 + x y).subs(x, pi) pi y + 1 (1 + x y).subs({x:pi, y:2}) 1 + 2 pi (1 + x y).subs([(x, pi), (y, 2)]) 1 + 2 pi reps = [(y, x 2), (x, 2)] (x + y).subs(reps) 6 (x + y).subs(reversed(reps)) x 2 + 2 (x 2 + x 4).subs(x 2, y) y 2 + y To replace only the x 2 but not the x 4, use xreplace: (x 2 + x 4).xreplace({x 2: y}) x 4 + y To delay evaluation until all substitutions have been made, set the keyword simultaneous to True: (x/y).subs([(x, 0), (y, 0)]) 0 (x/y).subs([(x, 0), (y, 0)], simultaneous=True) nan This has the added feature of not allowing subsequent substitutions to affect those already made: ((x + y)/y).subs({x + y: y, y: x + y}) 1 ((x + y)/y).subs({x + y: y, y: x + y}, simultaneous=True) y/(x + y) In order to obtain a canonical result, unordered iterables are sorted by count_op length, number of arguments and by the default_sort_key to break any ties. All other iterables are left unsorted. from sympy import sqrt, sin, cos from sympy.abc import a, b, c, d, e A = (sqrt(sin(2 x)), a) B = (sin(2 x), b) C = (cos(2*x), c) D = (x, d) E = (exp(x), e) expr = sqrt(sin(2 x)) sin(exp(x) x) cos(2 x) + sin(2 x) expr.subs(dict([A, B, C, D, E])) a c sin(d*e) + b The resulting expression represents a literal replacement of the old arguments with the new arguments. This may not reflect the limiting behavior of the expression: (x* 3 - 3 x).subs({x: oo}) nan limit(x* 3 - 3 x, x, oo) oo If the substitution will be followed by numerical evaluation, it is better to pass the substitution to evalf as (1/x).evalf(subs={x: 3.0}, n=21) 0.333333333333333333333 rather than (1/x).subs({x: 3.0}).evalf(21) 0.333333333333333314830 as the former will ensure that the desired level of precision is obtained.","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_63","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements xreplace: exact node replacement in expr tree; also capable of using matching rules sympy.core.evalf.EvalfMixin.evalf: calculates the given formula to a desired level of precision","title":"See Also"},{"location":"reference/dewret/workflow/#taylor_term_4","text":"def taylor_term ( self , n , x , * previous_terms ) General method for the taylor term. This method is slow, because it differentiates n-times. Subclasses can redefine it to make it faster by using the \"previous_terms\".","title":"taylor_term"},{"location":"reference/dewret/workflow/#to_nnf_4","text":"def to_nnf ( self , simplify = True )","title":"to_nnf"},{"location":"reference/dewret/workflow/#together_4","text":"def together ( self , * args , ** kwargs ) See the together function in sympy.polys","title":"together"},{"location":"reference/dewret/workflow/#transpose_4","text":"def transpose ( self )","title":"transpose"},{"location":"reference/dewret/workflow/#trigsimp_4","text":"def trigsimp ( self , ** args ) See the trigsimp function in sympy.simplify","title":"trigsimp"},{"location":"reference/dewret/workflow/#xreplace_4","text":"def xreplace ( self , rule , hack2 = False ) Replace occurrences of objects within the expression.","title":"xreplace"},{"location":"reference/dewret/workflow/#parameters_29","text":"rule : dict-like Expresses a replacement rule","title":"Parameters"},{"location":"reference/dewret/workflow/#returns_14","text":"xreplace : the result of the replacement","title":"Returns"},{"location":"reference/dewret/workflow/#examples_219","text":"from sympy import symbols, pi, exp x, y, z = symbols('x y z') (1 + x y).xreplace({x: pi}) pi y + 1 (1 + x y).xreplace({x: pi, y: 2}) 1 + 2 pi Replacements occur only if an entire node in the expression tree is matched: (x y + z).xreplace({x y: pi}) z + pi (x y z).xreplace({x y: pi}) x y z (2 x).xreplace({2 x: y, x: z}) y (2 2 x).xreplace({2 x: y, x: z}) 4*z (x + y + 2).xreplace({x + y: 2}) x + y + 2 (x + 2 + exp(x + 2)).xreplace({x + 2: y}) x + exp(y) + 2 xreplace does not differentiate between free and bound symbols. In the following, subs(x, y) would not change x since it is a bound symbol, but xreplace does: from sympy import Integral Integral(x, (x, 1, 2 x)).xreplace({x: y}) Integral(y, (y, 1, 2 y)) Trying to replace x with an expression raises an error: Integral(x, (x, 1, 2 x)).xreplace({x: 2 y}) # doctest: +SKIP ValueError: Invalid limits given: ((2 y, 1, 4 y),)","title":"Examples"},{"location":"reference/dewret/workflow/#see-also_64","text":"replace: replacement capable of doing wildcard-like matching, parsing of match, and conditional replacements subs: substitution of subexpressions as defined by the objects themselves.","title":"See Also"},{"location":"reference/dewret/workflow/#task","text":"class Task ( name : 'str' , target : 'Lazy' ) Named wrapper of a lazy-evaluatable function. Wraps a lazy-evaluatable function ( dewret.workflow.Lazy ) with any metadata needed to render it later. At present, this is the name.","title":"Task"},{"location":"reference/dewret/workflow/#attributes_5","text":"Name Type Description Default name None Name of the lazy function as it will appear in the output workflow text. None target None Callable that is wrapped. None","title":"Attributes"},{"location":"reference/dewret/workflow/#unsettype","text":"class UnsetType ( raw_type : 'type[T]' ) Unset variable with a specific type.","title":"UnsetType"},{"location":"reference/dewret/workflow/#attributes_6","text":"Name Type Description Default type None type of the variable. None","title":"Attributes"},{"location":"reference/dewret/workflow/#ancestors-in-mro_12","text":"dewret.utils.Unset typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/workflow/#workflow","text":"class Workflow ( name : 'str | None' = None ) Overarching workflow concept. Represents a whole workflow, as a singleton maintaining all state information needed ahead of rendering. It is built up as the lazy-evaluations are finally evaluated.","title":"Workflow"},{"location":"reference/dewret/workflow/#attributes_7","text":"Name Type Description Default steps None the sequence of calls to lazy-evaluable functions, built as they are evaluated. None tasks None the mapping of names used in the steps to the actual Task wrappers they represent. None result None target reference to evaluate, if yet present. None","title":"Attributes"},{"location":"reference/dewret/workflow/#static-methods_5","text":"","title":"Static methods"},{"location":"reference/dewret/workflow/#assimilate","text":"def assimilate ( * workflow_args : 'Workflow' ) -> \"'Workflow'\" Combine two Workflows into one Workflow. Takes two workflows and unifies them by combining steps and tasks. If it sees mismatched identifiers for the same component, it will error. This could happen if the hashing function is flawed or some Python magic to do with Targets being passed. Parameters: Name Type Description Default workflow_args None workflows to use as base None","title":"assimilate"},{"location":"reference/dewret/workflow/#from_result","text":"def from_result ( result : 'StepReference[Any] | list[StepReference[Any]] | tuple[StepReference[Any], ...]' , simplify_ids : 'bool' = False , nested : 'bool' = True ) -> 'Workflow' Create from a desired result. Starts from a result, and builds a workflow to output it.","title":"from_result"},{"location":"reference/dewret/workflow/#instance-variables_10","text":"has_result Confirms whether this workflow has a non-empty result. Either None or an empty list/tuple are considered empty for this purpose. Returns: True if the workflow has a result, False otherwise. id Consistent ID based off the step IDs. indexed_steps Steps mapped by ID. Forces generation of IDs. Note that this effectively freezes the steps, so it should not be used until we are confident the steps are all ready to be hashed. name Get the name of the workflow. result_type Overall return type of this workflow. steps Get deduplicated steps. Returns: steps for looping over without duplicates.","title":"Instance variables"},{"location":"reference/dewret/workflow/#methods_10","text":"","title":"Methods"},{"location":"reference/dewret/workflow/#add_nested_step","text":"def add_nested_step ( self , name : 'str' , subworkflow : 'Workflow' , return_type : 'type | None' , kwargs : 'dict[str, Any]' , positional_args : 'dict[str, bool] | None' = None ) -> 'StepReference[Any]' Append a nested step. Calls a subworkflow. Parameters: Name Type Description Default name None name of the subworkflow. None subworkflow None the subworkflow itself. None return_type None a forced type for the return, or None. None kwargs None any key-value arguments to pass in the call. None positional_args None a mapping of arguments to bools, True if the argument is positional or otherwise False. None","title":"add_nested_step"},{"location":"reference/dewret/workflow/#add_step","text":"def add_step ( self , fn : 'Lazy' , kwargs : 'dict[str, Raw | Reference[Any]]' , raw_as_parameter : 'bool' = False , is_factory : 'bool' = False , positional_args : 'dict[str, bool] | None' = None ) -> 'StepReference[Any]' Append a step. Adds a step, for running a target with key-value arguments, to the workflow. Parameters: Name Type Description Default fn None the target function to turn into a step. None kwargs None any key-value arguments to pass in the call. None raw_as_parameter None whether to turn any discovered raw arguments into workflow parameters. None is_factory None whether this step should be a Factory. None positional_args None a mapping of arguments to bools, True if the argument is positional or otherwise False. None","title":"add_step"},{"location":"reference/dewret/workflow/#find_factories","text":"def find_factories ( self ) -> 'dict[str, FactoryCall]' Steps that are factory calls.","title":"find_factories"},{"location":"reference/dewret/workflow/#find_parameters","text":"def find_parameters ( self , include_factory_calls : 'bool' = True ) -> 'set[Parameter[Any]]' Crawl steps for parameter references. As the workflow does not hold its own list of parameters, this dynamically finds them. Returns: Type Description None Set of all references to parameters across the steps.","title":"find_parameters"},{"location":"reference/dewret/workflow/#register_task","text":"def register_task ( self , fn : 'Lazy' ) -> 'Task' Note the existence of a lazy-evaluatable function, and wrap it as a Task . Parameters: Name Type Description Default fn None the wrapped function. None Returns: Type Description None A new Task that wraps the function, and is retained in the Workflow.tasks dict.","title":"register_task"},{"location":"reference/dewret/workflow/#remap","text":"def remap ( self , step_id : 'str' ) -> 'str' Apply name simplification if requested. Parameters: Name Type Description Default step_id None step to check. None Returns: Type Description None Same ID or a remapped name.","title":"remap"},{"location":"reference/dewret/workflow/#set_result","text":"def set_result ( self , result : 'Basic | list[Basic] | tuple[Basic]' ) -> 'None' Choose the result step. Sets a step as being the result for the entire workflow. When we evaluate a dynamic workflow, the engine (e.g. dask) creates a graph to realize the result of a single collection. Similarly, in the static case, we need to have a result that drives the calculation. Parameters: Name Type Description Default result None reference to the chosen step. None","title":"set_result"},{"location":"reference/dewret/workflow/#simplify_ids","text":"def simplify_ids ( self , infix : 'list[str] | None' = None ) -> 'None' Work out mapping to simple ints from hashes. Goes through and numbers each step by the order of use of its task.","title":"simplify_ids"},{"location":"reference/dewret/workflow/#workflowlinkedcomponent","text":"class WorkflowLinkedComponent ( * args , ** kwargs ) Protocol for objects dynamically tied to a Workflow .","title":"WorkflowLinkedComponent"},{"location":"reference/dewret/workflow/#ancestors-in-mro_13","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/backends/","text":"Module dewret.backends Backends for supplying lazy-evaluation. By default, we use dask, but it is possible to extend this functionality as the behaviour is encapsulated within these modules. Sub-modules dewret.backends.backend_dask","title":"Index"},{"location":"reference/dewret/backends/#module-dewretbackends","text":"Backends for supplying lazy-evaluation. By default, we use dask, but it is possible to extend this functionality as the behaviour is encapsulated within these modules.","title":"Module dewret.backends"},{"location":"reference/dewret/backends/#sub-modules","text":"dewret.backends.backend_dask","title":"Sub-modules"},{"location":"reference/dewret/backends/backend_dask/","text":"Module dewret.backends.backend_dask Dask backend. Lazy-evaluation via dask.delayed . Variables config Functions is_lazy def is_lazy ( task : Any ) -> bool Checks if a task is really a lazy-evaluated function for this backend. Parameters: Name Type Description Default task None suspected lazy-evaluated function. None Returns: Type Description None True if so, False otherwise. lazy def lazy ( obj = '__no__default__' , name = None , pure = None , nout = None , traverse = True ) Wraps a function or object to produce a Delayed . Delayed objects act as proxies for the object they wrap, but all operations on them are done lazily by building up a dask graph internally. Parameters: Name Type Description Default obj object The function or object to wrap None name Dask key The key to use in the underlying graph for the wrapped object. Defaults to hashing content. Note that this only affects the name of the object wrapped by this call to delayed, and not the output of delayed function calls - for that use dask_key_name= as described below. .. note:: Because this name is used as the key in task graphs, you should ensure that it uniquely identifies obj . If you'd like to provide a descriptive name that is still unique, combine the descriptive name with :func: dask.base.tokenize of the array_like . See :ref: graphs for more. s pure bool Indicates whether calling the resulting Delayed object is a pure operation. If True, arguments to the call are hashed to produce deterministic keys. If not provided, the default is to check the global delayed_pure setting, and fallback to False if unset. to nout int The number of outputs returned from calling the resulting Delayed object. If provided, the Delayed output of the call can be iterated into nout objects, allowing for unpacking of results. By default iteration over Delayed objects will error. Note, that nout=1 expects obj to return a tuple of length 1, and consequently for nout=0 , obj should return an empty tuple. iteration traverse bool By default dask traverses builtin python collections looking for dask objects passed to delayed . For large collections this can be expensive. If obj doesn't contain any dask objects, set traverse=False to avoid doing this traversal. dask run def run ( workflow : dewret . workflow . Workflow | None , task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Execute a task as the output of a workflow. Runs a task with dask. Parameters: Name Type Description Default workflow None Workflow in which to record the execution. None task None dask.delayed function, wrapped by dewret, that we wish to compute. None thread_pool None custom thread pool for executing workflows, copies in correct values for contextvars to each thread before they are accessed by a dask worker. None **kwargs None any configuration arguments for this backend. None unwrap def unwrap ( task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. In recent dask (>=2024.3) this works with inspect.wraps, but earlier versions do not have the __wrapped__ property. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function. Classes Delayed class Delayed ( * args , ** kwargs ) Description of a dask delayed . Since dask.delayed does not have a hintable type, this stands in its place, making sure that all the features of a dask.delayed are available. More info: https://github.com/dask/dask/issues/7779 Ancestors (in MRO) typing.Protocol typing.Generic Methods compute def compute ( self , __workflow__ : dewret . workflow . Workflow | None ) -> dewret . workflow . StepReference [ typing . Any ] Evaluate this dask.delayed . Evaluate a delayed (dask lazy-evaluated) function. dewret will have replaced it with a wrapper that expects a Workflow and all arguments will already be known to the wrapped delayed so the signature here is simple. Parameters: Name Type Description Default workflow None Workflow that this is tied to, if applicable. None Returns: Type Description None Reference to the final output step.","title":"Backend Dask"},{"location":"reference/dewret/backends/backend_dask/#module-dewretbackendsbackend_dask","text":"Dask backend. Lazy-evaluation via dask.delayed .","title":"Module dewret.backends.backend_dask"},{"location":"reference/dewret/backends/backend_dask/#variables","text":"config","title":"Variables"},{"location":"reference/dewret/backends/backend_dask/#functions","text":"","title":"Functions"},{"location":"reference/dewret/backends/backend_dask/#is_lazy","text":"def is_lazy ( task : Any ) -> bool Checks if a task is really a lazy-evaluated function for this backend. Parameters: Name Type Description Default task None suspected lazy-evaluated function. None Returns: Type Description None True if so, False otherwise.","title":"is_lazy"},{"location":"reference/dewret/backends/backend_dask/#lazy","text":"def lazy ( obj = '__no__default__' , name = None , pure = None , nout = None , traverse = True ) Wraps a function or object to produce a Delayed . Delayed objects act as proxies for the object they wrap, but all operations on them are done lazily by building up a dask graph internally. Parameters: Name Type Description Default obj object The function or object to wrap None name Dask key The key to use in the underlying graph for the wrapped object. Defaults to hashing content. Note that this only affects the name of the object wrapped by this call to delayed, and not the output of delayed function calls - for that use dask_key_name= as described below. .. note:: Because this name is used as the key in task graphs, you should ensure that it uniquely identifies obj . If you'd like to provide a descriptive name that is still unique, combine the descriptive name with :func: dask.base.tokenize of the array_like . See :ref: graphs for more. s pure bool Indicates whether calling the resulting Delayed object is a pure operation. If True, arguments to the call are hashed to produce deterministic keys. If not provided, the default is to check the global delayed_pure setting, and fallback to False if unset. to nout int The number of outputs returned from calling the resulting Delayed object. If provided, the Delayed output of the call can be iterated into nout objects, allowing for unpacking of results. By default iteration over Delayed objects will error. Note, that nout=1 expects obj to return a tuple of length 1, and consequently for nout=0 , obj should return an empty tuple. iteration traverse bool By default dask traverses builtin python collections looking for dask objects passed to delayed . For large collections this can be expensive. If obj doesn't contain any dask objects, set traverse=False to avoid doing this traversal. dask","title":"lazy"},{"location":"reference/dewret/backends/backend_dask/#run","text":"def run ( workflow : dewret . workflow . Workflow | None , task : dewret . workflow . Lazy | list [ dewret . workflow . Lazy ] | tuple [ dewret . workflow . Lazy ], thread_pool : concurrent . futures . thread . ThreadPoolExecutor | None = None , ** kwargs : Any ) -> Any Execute a task as the output of a workflow. Runs a task with dask. Parameters: Name Type Description Default workflow None Workflow in which to record the execution. None task None dask.delayed function, wrapped by dewret, that we wish to compute. None thread_pool None custom thread pool for executing workflows, copies in correct values for contextvars to each thread before they are accessed by a dask worker. None **kwargs None any configuration arguments for this backend. None","title":"run"},{"location":"reference/dewret/backends/backend_dask/#unwrap","text":"def unwrap ( task : dewret . workflow . Lazy ) -> collections . abc . Callable [ ... , typing . Any ] Unwraps a lazy-evaluated function to get the function. In recent dask (>=2024.3) this works with inspect.wraps, but earlier versions do not have the __wrapped__ property. Parameters: Name Type Description Default task None task to be unwrapped. None Returns: Type Description None Original target. Raises: Type Description RuntimeError if the task is not a wrapped function.","title":"unwrap"},{"location":"reference/dewret/backends/backend_dask/#classes","text":"","title":"Classes"},{"location":"reference/dewret/backends/backend_dask/#delayed","text":"class Delayed ( * args , ** kwargs ) Description of a dask delayed . Since dask.delayed does not have a hintable type, this stands in its place, making sure that all the features of a dask.delayed are available. More info: https://github.com/dask/dask/issues/7779","title":"Delayed"},{"location":"reference/dewret/backends/backend_dask/#ancestors-in-mro","text":"typing.Protocol typing.Generic","title":"Ancestors (in MRO)"},{"location":"reference/dewret/backends/backend_dask/#methods","text":"","title":"Methods"},{"location":"reference/dewret/backends/backend_dask/#compute","text":"def compute ( self , __workflow__ : dewret . workflow . Workflow | None ) -> dewret . workflow . StepReference [ typing . Any ] Evaluate this dask.delayed . Evaluate a delayed (dask lazy-evaluated) function. dewret will have replaced it with a wrapper that expects a Workflow and all arguments will already be known to the wrapped delayed so the signature here is simple. Parameters: Name Type Description Default workflow None Workflow that this is tied to, if applicable. None Returns: Type Description None Reference to the final output step.","title":"compute"},{"location":"reference/dewret/renderers/","text":"Module dewret.renderers Renderers for outputting static workflow representations. Take a Workflow and output a static representation in the desired format. Sub-modules dewret.renderers.cwl dewret.renderers.snakemake","title":"Index"},{"location":"reference/dewret/renderers/#module-dewretrenderers","text":"Renderers for outputting static workflow representations. Take a Workflow and output a static representation in the desired format.","title":"Module dewret.renderers"},{"location":"reference/dewret/renderers/#sub-modules","text":"dewret.renderers.cwl dewret.renderers.snakemake","title":"Sub-modules"},{"location":"reference/dewret/renderers/cwl/","text":"Module dewret.renderers.cwl CWL Renderer. Outputs a Common Workflow Language representation of the current workflow. Variables InputSchemaType Functions cwl_type_from_value def cwl_type_from_value ( label : str , val : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset ) -> dewret . renderers . cwl . CommandInputSchema Find a CWL type for a given (possibly Unset) value. Parameters: Name Type Description Default label None the label for the variable being checked to prefill the input def and improve debugging info. None val None a raw Python variable or an unset variable. None Returns: Type Description None Input schema type. default_config def default_config ( ) -> dewret . renderers . cwl . CWLRendererConfiguration Default configuration for this renderer. This is a hook-like call to give a configuration dict that this renderer will respect, and sets any necessary default values. Returns: a dict with (preferably) raw type structures to enable easy setting from YAML/JSON. raw_to_command_input_schema def raw_to_command_input_schema ( label : str , value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset ) -> str | dewret . renderers . cwl . CommandInputSchema | list [ str ] | list [ 'InputSchemaType' ] | dict [ str , 'str | InputSchemaType' ] Infer the CWL input structure for this value. Inspects the value, to work out an appropriate structure describing it in CWL. Parameters: Name Type Description Default label None name of the variable. None value None basic-typed variable from which to build structure. None Returns: Type Description None Structure used to define (possibly compound) basic types for input. render def render ( workflow : dewret . workflow . Workflow , ** kwargs : *< class ' dewret . renderers . cwl . CWLRendererConfiguration '> ) -> dict [ str , dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]]] Render to a dict-like structure. Parameters: Name Type Description Default workflow None workflow to evaluate result. None **kwargs None additional configuration arguments - these should match CWLRendererConfiguration. None Returns: Type Description None Reduced form as a native Python dict structure for serialization. render_expression def render_expression ( ref : Any ) -> 'ReferenceDefinition' Turn a rich (sympy) expression into a CWL JS expression. Parameters: Name Type Description Default ref None a structure whose elements are all string-renderable or sympy Basic. None to_cwl_type def to_cwl_type ( label : str , typ : type ) -> dewret . renderers . cwl . CommandInputSchema Map Python types to CWL types. Parameters: Name Type Description Default label None the label for the variable being checked to prefill the input def and improve debugging info. None typ None a Python basic type. None Returns: Type Description None CWL specification type dict. to_name def to_name ( result : dewret . core . Reference [ typing . Any ] ) -> str Take a reference and get a name representing it. The primary purpose of this method is to deal with the case where a reference is to the whole result, as we always put this into an imagined out field for CWL consistency. Returns: the name of the reference, including any field portion, appending an \"out\" fieldname if none. to_output_schema def to_output_schema ( label : str , typ : type [ str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | attr . AttrsInstance | dewret . utils . DataclassProtocol ], output_source : str | None = None ) -> dewret . renderers . cwl . CommandOutputSchema Turn a step's output into an output schema. Takes a source, type and label and provides a description for CWL. Parameters: Name Type Description Default label None name of this field. None typ None either a basic type, compound of basic types, or a TypedDict representing a pre-defined result structure. None output_source None if provided, a CWL step result reference to input here. None Returns: Type Description None CWL CommandOutputSchema-like structure for embedding into an outputs block with_field def with_field ( result : Any ) -> str Get a string representing any 'field' suffix of a value. This only makes sense in the context of a Reference, which can represent a deep reference with a known variable (parameter or step result, say) using its __field__ attribute. Defaults to \"out\" as this produces compliant CWL where every output has a \"fieldname\". Returns: a string representation of the field portion of the passed value or \"out\" . with_type def with_type ( result : Any ) -> type | typing . Any Get a Python type from a value. Does so either by using its __type__ field (for example, for References) or if unavailable, using type() . Returns: a Python type. Classes CWLRendererConfiguration class CWLRendererConfiguration ( / , * args , ** kwargs ) Configuration for the renderer. Attributes Name Type Description Default allow_complex_types None can input/output types be other than raw? None factories_as_params None should factories be treated as input or steps? None Ancestors (in MRO) builtins.dict Methods clear def clear ( ... ) D.clear() -> None. Remove all items from D. copy def copy ( ... ) D.copy() -> a shallow copy of D fromkeys def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value. get def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default. items def items ( ... ) D.items() -> a set-like object providing a view on D's items keys def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys pop def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError. popitem def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty. setdefault def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default. update def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k] values def values ( ... ) D.values() -> an object providing a view on D's values CommandInputSchema class CommandInputSchema ( / , * args , ** kwargs ) Structure for referring to a raw type in CWL. Encompasses several CWL types. In future, it may be best to use cwltool or another library for these basic structures. Attributes Name Type Description Default type None CWL type of this input. None label None name to show for this input. None fields None (for record ) individual fields in a dict-like structure. None items None (for array ) type that each field will have. None Ancestors (in MRO) builtins.dict Methods clear def clear ( ... ) D.clear() -> None. Remove all items from D. copy def copy ( ... ) D.copy() -> a shallow copy of D fromkeys def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value. get def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default. items def items ( ... ) D.items() -> a set-like object providing a view on D's items keys def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys pop def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError. popitem def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty. setdefault def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default. update def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k] values def values ( ... ) D.values() -> an object providing a view on D's values CommandOutputSchema class CommandOutputSchema ( / , * args , ** kwargs ) Structure for referring to an output in CWL. As a simplification, this is an input schema with an extra outputSource field. Attributes Name Type Description Default outputSource None step result to use for this output. None Ancestors (in MRO) builtins.dict Methods clear def clear ( ... ) D.clear() -> None. Remove all items from D. copy def copy ( ... ) D.copy() -> a shallow copy of D fromkeys def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value. get def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default. items def items ( ... ) D.items() -> a set-like object providing a view on D's items keys def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys pop def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError. popitem def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty. setdefault def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default. update def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k] values def values ( ... ) D.values() -> an object providing a view on D's values InputsDefinition class InputsDefinition ( inputs : dict [ str , 'CommandInputParameter' ] ) CWL-renderable representation of an input parameter block. Turns dewret results into a CWL input block. Attributes Name Type Description Default input None sequence of results from a workflow. None Class variables CommandInputParameter Static methods from_parameters def from_parameters ( parameters : list [ typing . Union [ dewret . workflow . ParameterReference [ typing . Any ], dewret . workflow . FactoryCall ]] ) -> 'InputsDefinition' Takes a list of parameters into a CWL structure. Uses the parameters to fill out the necessary input fields. Returns: Type Description None CWL-like structure representing all workflow outputs. Instance variables inputs Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization. OutputsDefinition class OutputsDefinition ( outputs : dict [ str , 'CommandOutputSchema' ] | list [ 'CommandOutputSchema' ] | dewret . renderers . cwl . CommandOutputSchema ) CWL-renderable set of workflow outputs. Turns dewret results into a CWL output block. Attributes Name Type Description Default outputs None sequence of results from a workflow. None Static methods from_results def from_results ( results : dict [ str , dewret . workflow . StepReference [ typing . Any ]] | list [ dewret . workflow . StepReference [ typing . Any ]] | tuple [ dewret . workflow . StepReference [ typing . Any ], ... ] ) -> 'OutputsDefinition' Takes a mapping of results into a CWL structure. Pulls the result type from the signature, ultimately, if possible. Returns: Type Description None CWL-like structure representing all workflow outputs. Instance variables outputs Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] | list [ str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization. ReferenceDefinition class ReferenceDefinition ( source : str | None , value_from : str | None ) CWL-renderable internal reference. Normally points to a value or a step. Static methods from_reference def from_reference ( ref : dewret . core . Reference [ typing . Any ] ) -> 'ReferenceDefinition' Build from a Reference . Converts a dewret.workflow.Reference into a CWL-rendering object. Parameters: Name Type Description Default ref None reference to convert. None Instance variables source value_from Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization. StepDefinition class StepDefinition ( name : str , run : str , out : dict [ str , 'CommandInputSchema' ] | list [ str ], in_ : collections . abc . Mapping [ str , dewret . renderers . cwl . ReferenceDefinition | dewret . core . Raw ] ) CWL-renderable step. Coerces the dewret structure of a step into that needed for valid CWL. Attributes Name Type Description Default name None identifier to call this step by. None run None task to execute for this step. None in_ None inputs from values or other steps. None Static methods from_step def from_step ( step : dewret . workflow . BaseStep ) -> 'StepDefinition' Build from a BaseStep . Converts a dewret.workflow.Step into a CWL-rendering object. Parameters: Name Type Description Default step None step to convert. None Instance variables in_ name out run Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization. WorkflowDefinition class WorkflowDefinition ( steps : list [ dewret . renderers . cwl . StepDefinition ], inputs : dewret . renderers . cwl . InputsDefinition , outputs : dewret . renderers . cwl . OutputsDefinition , name : None | str ) CWL-renderable workflow. Coerces the dewret structure of a workflow into that needed for valid CWL. Attributes Name Type Description Default steps None sequence of steps in the workflow. None Static methods from_workflow def from_workflow ( workflow : dewret . workflow . Workflow , name : None | str = None ) -> 'WorkflowDefinition' Build from a Workflow . Converts a dewret.workflow.Workflow into a CWL-rendering object. Parameters: Name Type Description Default workflow None workflow to convert. None name None name of this workflow, if it should have one. None Instance variables inputs name outputs steps Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"Cwl"},{"location":"reference/dewret/renderers/cwl/#module-dewretrendererscwl","text":"CWL Renderer. Outputs a Common Workflow Language representation of the current workflow.","title":"Module dewret.renderers.cwl"},{"location":"reference/dewret/renderers/cwl/#variables","text":"InputSchemaType","title":"Variables"},{"location":"reference/dewret/renderers/cwl/#functions","text":"","title":"Functions"},{"location":"reference/dewret/renderers/cwl/#cwl_type_from_value","text":"def cwl_type_from_value ( label : str , val : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset ) -> dewret . renderers . cwl . CommandInputSchema Find a CWL type for a given (possibly Unset) value. Parameters: Name Type Description Default label None the label for the variable being checked to prefill the input def and improve debugging info. None val None a raw Python variable or an unset variable. None Returns: Type Description None Input schema type.","title":"cwl_type_from_value"},{"location":"reference/dewret/renderers/cwl/#default_config","text":"def default_config ( ) -> dewret . renderers . cwl . CWLRendererConfiguration Default configuration for this renderer. This is a hook-like call to give a configuration dict that this renderer will respect, and sets any necessary default values. Returns: a dict with (preferably) raw type structures to enable easy setting from YAML/JSON.","title":"default_config"},{"location":"reference/dewret/renderers/cwl/#raw_to_command_input_schema","text":"def raw_to_command_input_schema ( label : str , value : str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | dewret . utils . Unset ) -> str | dewret . renderers . cwl . CommandInputSchema | list [ str ] | list [ 'InputSchemaType' ] | dict [ str , 'str | InputSchemaType' ] Infer the CWL input structure for this value. Inspects the value, to work out an appropriate structure describing it in CWL. Parameters: Name Type Description Default label None name of the variable. None value None basic-typed variable from which to build structure. None Returns: Type Description None Structure used to define (possibly compound) basic types for input.","title":"raw_to_command_input_schema"},{"location":"reference/dewret/renderers/cwl/#render","text":"def render ( workflow : dewret . workflow . Workflow , ** kwargs : *< class ' dewret . renderers . cwl . CWLRendererConfiguration '> ) -> dict [ str , dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]]] Render to a dict-like structure. Parameters: Name Type Description Default workflow None workflow to evaluate result. None **kwargs None additional configuration arguments - these should match CWLRendererConfiguration. None Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/cwl/#render_expression","text":"def render_expression ( ref : Any ) -> 'ReferenceDefinition' Turn a rich (sympy) expression into a CWL JS expression. Parameters: Name Type Description Default ref None a structure whose elements are all string-renderable or sympy Basic. None","title":"render_expression"},{"location":"reference/dewret/renderers/cwl/#to_cwl_type","text":"def to_cwl_type ( label : str , typ : type ) -> dewret . renderers . cwl . CommandInputSchema Map Python types to CWL types. Parameters: Name Type Description Default label None the label for the variable being checked to prefill the input def and improve debugging info. None typ None a Python basic type. None Returns: Type Description None CWL specification type dict.","title":"to_cwl_type"},{"location":"reference/dewret/renderers/cwl/#to_name","text":"def to_name ( result : dewret . core . Reference [ typing . Any ] ) -> str Take a reference and get a name representing it. The primary purpose of this method is to deal with the case where a reference is to the whole result, as we always put this into an imagined out field for CWL consistency. Returns: the name of the reference, including any field portion, appending an \"out\" fieldname if none.","title":"to_name"},{"location":"reference/dewret/renderers/cwl/#to_output_schema","text":"def to_output_schema ( label : str , typ : type [ str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ] | attr . AttrsInstance | dewret . utils . DataclassProtocol ], output_source : str | None = None ) -> dewret . renderers . cwl . CommandOutputSchema Turn a step's output into an output schema. Takes a source, type and label and provides a description for CWL. Parameters: Name Type Description Default label None name of this field. None typ None either a basic type, compound of basic types, or a TypedDict representing a pre-defined result structure. None output_source None if provided, a CWL step result reference to input here. None Returns: Type Description None CWL CommandOutputSchema-like structure for embedding into an outputs block","title":"to_output_schema"},{"location":"reference/dewret/renderers/cwl/#with_field","text":"def with_field ( result : Any ) -> str Get a string representing any 'field' suffix of a value. This only makes sense in the context of a Reference, which can represent a deep reference with a known variable (parameter or step result, say) using its __field__ attribute. Defaults to \"out\" as this produces compliant CWL where every output has a \"fieldname\". Returns: a string representation of the field portion of the passed value or \"out\" .","title":"with_field"},{"location":"reference/dewret/renderers/cwl/#with_type","text":"def with_type ( result : Any ) -> type | typing . Any Get a Python type from a value. Does so either by using its __type__ field (for example, for References) or if unavailable, using type() . Returns: a Python type.","title":"with_type"},{"location":"reference/dewret/renderers/cwl/#classes","text":"","title":"Classes"},{"location":"reference/dewret/renderers/cwl/#cwlrendererconfiguration","text":"class CWLRendererConfiguration ( / , * args , ** kwargs ) Configuration for the renderer.","title":"CWLRendererConfiguration"},{"location":"reference/dewret/renderers/cwl/#attributes","text":"Name Type Description Default allow_complex_types None can input/output types be other than raw? None factories_as_params None should factories be treated as input or steps? None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#ancestors-in-mro","text":"builtins.dict","title":"Ancestors (in MRO)"},{"location":"reference/dewret/renderers/cwl/#methods","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#clear","text":"def clear ( ... ) D.clear() -> None. Remove all items from D.","title":"clear"},{"location":"reference/dewret/renderers/cwl/#copy","text":"def copy ( ... ) D.copy() -> a shallow copy of D","title":"copy"},{"location":"reference/dewret/renderers/cwl/#fromkeys","text":"def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value.","title":"fromkeys"},{"location":"reference/dewret/renderers/cwl/#get","text":"def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default.","title":"get"},{"location":"reference/dewret/renderers/cwl/#items","text":"def items ( ... ) D.items() -> a set-like object providing a view on D's items","title":"items"},{"location":"reference/dewret/renderers/cwl/#keys","text":"def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys","title":"keys"},{"location":"reference/dewret/renderers/cwl/#pop","text":"def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError.","title":"pop"},{"location":"reference/dewret/renderers/cwl/#popitem","text":"def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.","title":"popitem"},{"location":"reference/dewret/renderers/cwl/#setdefault","text":"def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default.","title":"setdefault"},{"location":"reference/dewret/renderers/cwl/#update","text":"def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]","title":"update"},{"location":"reference/dewret/renderers/cwl/#values","text":"def values ( ... ) D.values() -> an object providing a view on D's values","title":"values"},{"location":"reference/dewret/renderers/cwl/#commandinputschema","text":"class CommandInputSchema ( / , * args , ** kwargs ) Structure for referring to a raw type in CWL. Encompasses several CWL types. In future, it may be best to use cwltool or another library for these basic structures.","title":"CommandInputSchema"},{"location":"reference/dewret/renderers/cwl/#attributes_1","text":"Name Type Description Default type None CWL type of this input. None label None name to show for this input. None fields None (for record ) individual fields in a dict-like structure. None items None (for array ) type that each field will have. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#ancestors-in-mro_1","text":"builtins.dict","title":"Ancestors (in MRO)"},{"location":"reference/dewret/renderers/cwl/#methods_1","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#clear_1","text":"def clear ( ... ) D.clear() -> None. Remove all items from D.","title":"clear"},{"location":"reference/dewret/renderers/cwl/#copy_1","text":"def copy ( ... ) D.copy() -> a shallow copy of D","title":"copy"},{"location":"reference/dewret/renderers/cwl/#fromkeys_1","text":"def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value.","title":"fromkeys"},{"location":"reference/dewret/renderers/cwl/#get_1","text":"def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default.","title":"get"},{"location":"reference/dewret/renderers/cwl/#items_1","text":"def items ( ... ) D.items() -> a set-like object providing a view on D's items","title":"items"},{"location":"reference/dewret/renderers/cwl/#keys_1","text":"def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys","title":"keys"},{"location":"reference/dewret/renderers/cwl/#pop_1","text":"def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError.","title":"pop"},{"location":"reference/dewret/renderers/cwl/#popitem_1","text":"def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.","title":"popitem"},{"location":"reference/dewret/renderers/cwl/#setdefault_1","text":"def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default.","title":"setdefault"},{"location":"reference/dewret/renderers/cwl/#update_1","text":"def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]","title":"update"},{"location":"reference/dewret/renderers/cwl/#values_1","text":"def values ( ... ) D.values() -> an object providing a view on D's values","title":"values"},{"location":"reference/dewret/renderers/cwl/#commandoutputschema","text":"class CommandOutputSchema ( / , * args , ** kwargs ) Structure for referring to an output in CWL. As a simplification, this is an input schema with an extra outputSource field.","title":"CommandOutputSchema"},{"location":"reference/dewret/renderers/cwl/#attributes_2","text":"Name Type Description Default outputSource None step result to use for this output. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#ancestors-in-mro_2","text":"builtins.dict","title":"Ancestors (in MRO)"},{"location":"reference/dewret/renderers/cwl/#methods_2","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#clear_2","text":"def clear ( ... ) D.clear() -> None. Remove all items from D.","title":"clear"},{"location":"reference/dewret/renderers/cwl/#copy_2","text":"def copy ( ... ) D.copy() -> a shallow copy of D","title":"copy"},{"location":"reference/dewret/renderers/cwl/#fromkeys_2","text":"def fromkeys ( iterable , value = None , / ) Create a new dictionary with keys from iterable and values set to value.","title":"fromkeys"},{"location":"reference/dewret/renderers/cwl/#get_2","text":"def get ( self , key , default = None , / ) Return the value for key if key is in the dictionary, else default.","title":"get"},{"location":"reference/dewret/renderers/cwl/#items_2","text":"def items ( ... ) D.items() -> a set-like object providing a view on D's items","title":"items"},{"location":"reference/dewret/renderers/cwl/#keys_2","text":"def keys ( ... ) D.keys() -> a set-like object providing a view on D's keys","title":"keys"},{"location":"reference/dewret/renderers/cwl/#pop_2","text":"def pop ( ... ) D.pop(k[,d]) -> v, remove specified key and return the corresponding value. If the key is not found, return the default if given; otherwise, raise a KeyError.","title":"pop"},{"location":"reference/dewret/renderers/cwl/#popitem_2","text":"def popitem ( self , / ) Remove and return a (key, value) pair as a 2-tuple. Pairs are returned in LIFO (last-in, first-out) order. Raises KeyError if the dict is empty.","title":"popitem"},{"location":"reference/dewret/renderers/cwl/#setdefault_2","text":"def setdefault ( self , key , default = None , / ) Insert key with a value of default if key is not in the dictionary. Return the value for key if key is in the dictionary, else default.","title":"setdefault"},{"location":"reference/dewret/renderers/cwl/#update_2","text":"def update ( ... ) D.update([E, ]**F) -> None. Update D from dict/iterable E and F. If E is present and has a .keys() method, then does: for k in E: D[k] = E[k] If E is present and lacks a .keys() method, then does: for k, v in E: D[k] = v In either case, this is followed by: for k in F: D[k] = F[k]","title":"update"},{"location":"reference/dewret/renderers/cwl/#values_2","text":"def values ( ... ) D.values() -> an object providing a view on D's values","title":"values"},{"location":"reference/dewret/renderers/cwl/#inputsdefinition","text":"class InputsDefinition ( inputs : dict [ str , 'CommandInputParameter' ] ) CWL-renderable representation of an input parameter block. Turns dewret results into a CWL input block.","title":"InputsDefinition"},{"location":"reference/dewret/renderers/cwl/#attributes_3","text":"Name Type Description Default input None sequence of results from a workflow. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#class-variables","text":"CommandInputParameter","title":"Class variables"},{"location":"reference/dewret/renderers/cwl/#static-methods","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/cwl/#from_parameters","text":"def from_parameters ( parameters : list [ typing . Union [ dewret . workflow . ParameterReference [ typing . Any ], dewret . workflow . FactoryCall ]] ) -> 'InputsDefinition' Takes a list of parameters into a CWL structure. Uses the parameters to fill out the necessary input fields. Returns: Type Description None CWL-like structure representing all workflow outputs.","title":"from_parameters"},{"location":"reference/dewret/renderers/cwl/#instance-variables","text":"inputs","title":"Instance variables"},{"location":"reference/dewret/renderers/cwl/#methods_3","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#render_1","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/cwl/#outputsdefinition","text":"class OutputsDefinition ( outputs : dict [ str , 'CommandOutputSchema' ] | list [ 'CommandOutputSchema' ] | dewret . renderers . cwl . CommandOutputSchema ) CWL-renderable set of workflow outputs. Turns dewret results into a CWL output block.","title":"OutputsDefinition"},{"location":"reference/dewret/renderers/cwl/#attributes_4","text":"Name Type Description Default outputs None sequence of results from a workflow. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#static-methods_1","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/cwl/#from_results","text":"def from_results ( results : dict [ str , dewret . workflow . StepReference [ typing . Any ]] | list [ dewret . workflow . StepReference [ typing . Any ]] | tuple [ dewret . workflow . StepReference [ typing . Any ], ... ] ) -> 'OutputsDefinition' Takes a mapping of results into a CWL structure. Pulls the result type from the signature, ultimately, if possible. Returns: Type Description None CWL-like structure representing all workflow outputs.","title":"from_results"},{"location":"reference/dewret/renderers/cwl/#instance-variables_1","text":"outputs","title":"Instance variables"},{"location":"reference/dewret/renderers/cwl/#methods_4","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#render_2","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] | list [ str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/cwl/#referencedefinition","text":"class ReferenceDefinition ( source : str | None , value_from : str | None ) CWL-renderable internal reference. Normally points to a value or a step.","title":"ReferenceDefinition"},{"location":"reference/dewret/renderers/cwl/#static-methods_2","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/cwl/#from_reference","text":"def from_reference ( ref : dewret . core . Reference [ typing . Any ] ) -> 'ReferenceDefinition' Build from a Reference . Converts a dewret.workflow.Reference into a CWL-rendering object. Parameters: Name Type Description Default ref None reference to convert. None","title":"from_reference"},{"location":"reference/dewret/renderers/cwl/#instance-variables_2","text":"source value_from","title":"Instance variables"},{"location":"reference/dewret/renderers/cwl/#methods_5","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#render_3","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/cwl/#stepdefinition","text":"class StepDefinition ( name : str , run : str , out : dict [ str , 'CommandInputSchema' ] | list [ str ], in_ : collections . abc . Mapping [ str , dewret . renderers . cwl . ReferenceDefinition | dewret . core . Raw ] ) CWL-renderable step. Coerces the dewret structure of a step into that needed for valid CWL.","title":"StepDefinition"},{"location":"reference/dewret/renderers/cwl/#attributes_5","text":"Name Type Description Default name None identifier to call this step by. None run None task to execute for this step. None in_ None inputs from values or other steps. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#static-methods_3","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/cwl/#from_step","text":"def from_step ( step : dewret . workflow . BaseStep ) -> 'StepDefinition' Build from a BaseStep . Converts a dewret.workflow.Step into a CWL-rendering object. Parameters: Name Type Description Default step None step to convert. None","title":"from_step"},{"location":"reference/dewret/renderers/cwl/#instance-variables_3","text":"in_ name out run","title":"Instance variables"},{"location":"reference/dewret/renderers/cwl/#methods_6","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#render_4","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/cwl/#workflowdefinition","text":"class WorkflowDefinition ( steps : list [ dewret . renderers . cwl . StepDefinition ], inputs : dewret . renderers . cwl . InputsDefinition , outputs : dewret . renderers . cwl . OutputsDefinition , name : None | str ) CWL-renderable workflow. Coerces the dewret structure of a workflow into that needed for valid CWL.","title":"WorkflowDefinition"},{"location":"reference/dewret/renderers/cwl/#attributes_6","text":"Name Type Description Default steps None sequence of steps in the workflow. None","title":"Attributes"},{"location":"reference/dewret/renderers/cwl/#static-methods_4","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/cwl/#from_workflow","text":"def from_workflow ( workflow : dewret . workflow . Workflow , name : None | str = None ) -> 'WorkflowDefinition' Build from a Workflow . Converts a dewret.workflow.Workflow into a CWL-rendering object. Parameters: Name Type Description Default workflow None workflow to convert. None name None name of this workflow, if it should have one. None","title":"from_workflow"},{"location":"reference/dewret/renderers/cwl/#instance-variables_4","text":"inputs name outputs steps","title":"Instance variables"},{"location":"reference/dewret/renderers/cwl/#methods_7","text":"","title":"Methods"},{"location":"reference/dewret/renderers/cwl/#render_5","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ 'RawType' ] | dict [ str , 'RawType' ]] Render to a dict-like structure. Returns: Type Description None Reduced form as a native Python dict structure for serialization.","title":"render"},{"location":"reference/dewret/renderers/snakemake/","text":"Module dewret.renderers.snakemake Snakemake Renderer. Outputs a Snakemake representation of the current workflow. Variables MainTypes Functions get_method_args def get_method_args ( func : dewret . workflow . Lazy ) -> inspect . Signature Retrieve the argument names and types of a lazy-evaluatable function. Parameters: Name Type Description Default func None A function that adheres to the Lazy protocol. None Returns: Type Description None An ItemsView object containing the argument names and their corresponding inspect.Parameter objects. get_method_rel_path def get_method_rel_path ( func : dewret . workflow . Lazy ) -> Any Get the relative path of the module containing the given function. Parameters: Name Type Description Default func Lazy The function for which the relative path is to be determined. None Returns: Type Description any The relative path of the module containing the function. raw_render def raw_render ( workflow : dewret . workflow . Workflow ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Render the workflow as a Snakemake (SMK) string. This function converts a Workflow object into a object containing snakemake rules. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the Workflow definition, for use in Snakemake workflows. render def render ( workflow : dewret . workflow . Workflow ) -> dict [ str , typing . Any ] Render the workflow as a Snakemake (SMK) string. This function converts a Workflow object into a Snakemake-compatible yaml. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description str A Snakemake-compatible yaml representation of the workflow. to_snakemake_type def to_snakemake_type ( param : dewret . core . Raw ) -> str Convert a raw type to a corresponding Snakemake-compatible Python type. This function maps raw types to their corresponding Python types as used in Snakemake. Snakemake primarily uses Python types for its parameters, and this function ensures that the provided type is appropriately converted. Parameters: Name Type Description Default param None The raw type to be converted, which can be of any type. None Returns: Type Description None A string representing the corresponding Python type for Snakemake. Raises: Type Description TypeError If the parameter's type cannot be mapped to a known Python type. Classes InputDefinition class InputDefinition ( inputs : list [ str ], params : list [ str ] ) Represents input and parameter definitions block for a Snakemake-renderable workflow step. Attributes Name Type Description Default inputs List[str] A list of input definitions. None params List[str] A list of parameter definitions. None Static methods from_step def from_step ( step : dewret . workflow . BaseStep ) -> 'InputDefinition' Constructs an InputDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which input and parameter block definitions are extracted. None Returns: Type Description InputDefinition An InputDefinition object. Instance variables inputs params Methods render def render ( self ) -> dict [ str , list [ str ]] Renders the input and parameter definitions as a dictionary. Returns: Type Description dict[str, list[MainTypes]] A dictionary containing the input and parameter definitions, for use in Snakemake Input and Params blocks. OutputDefinition class OutputDefinition ( output_file : str ) Represents the output definition block for a Snakemake-renderable workflow step. Attributes Name Type Description Default output_file str The output file definition. None Static methods from_step def from_step ( step : dewret . workflow . BaseStep ) -> 'OutputDefinition' Constructs an OutputDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which the output file definition is extracted. None Returns: Type Description OutputDefinition An OutputDefinition object, for use in Snakemake Output block. Instance variables output_file Methods render def render ( self ) -> list [ str ] Renders the output definition as a list. Returns: Type Description list[str] A list containing the output file definition, for use in a Snakemake Output block. ReferenceDefinition class ReferenceDefinition ( source : str ) Represents a Snakemake-renderable internal reference. Attributes Name Type Description Default source str The source of the internal reference. None Static methods from_reference def from_reference ( ref : dewret . core . Reference [ typing . Any ] ) -> 'ReferenceDefinition' Build from a Reference . Converts a dewret.workflow.Reference into a Snakemake-rendering object. Parameters: Name Type Description Default ref None reference to convert. None Instance variables source Methods render def render ( self ) -> str Render the internal reference definition as a string. Returns: Type Description str internal reference. RunDefinition class RunDefinition ( method_name : str , rel_import : str , args : list [ str ] ) Represents a Snakemake-renderable run block for a dewret workflow step. Attributes Name Type Description Default method_name str The name of the method to be executed in the snakefile run block. None rel_import str The relative import path of the method. None args List[str] The arguments to be passed to the method. None Static methods from_task def from_task ( task : dewret . workflow . Task | dewret . workflow . Workflow ) -> 'RunDefinition' Constructs a RunDefinition object from a Task. Parameters: Name Type Description Default task Task The Task object from which method information and arguments are extracted. None Returns: Type Description RunDefinition A RunDefinition object containing the converted method information and arguments. Instance variables args method_name rel_import Methods render def render ( self ) -> list [ str ] Renders the run block as a list of strings. Returns: Type Description list[str] A list containing the import statement and the method call statement, for use in Snakemake run block. StepDefinition class StepDefinition ( name : str , run : list [ str ], params : list [ str ], output : list [ str ], input : list [ str ] ) Represents a Snakemake-renderable step definition in a dewret workflow. Attributes Name Type Description Default name str The name of the step. None run str The run block definition for the step. None params List[str] The parameter definitions for the step. None output (list[str] None The output definition for the step. None input List[str] The input definitions for the step. None Static methods from_step def from_step ( step : dewret . workflow . BaseStep ) -> 'StepDefinition' Constructs a StepDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which step information and components are extracted. None Returns: Type Description StepDefinition A StepDefinition object containing the converted step information and components. Instance variables input name output params run Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Renders the step definition as a dictionary. Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the step definition, for use in Snakemake workflows. WorkflowDefinition class WorkflowDefinition ( steps : list [ dewret . renderers . snakemake . StepDefinition ] ) Represents a Snakemake-renderable workflow definition from a dewret workflow. Attributes Name Type Description Default steps List[StepDefinition] A list of StepDefinition objects representing the steps in the workflow. None Static methods from_workflow def from_workflow ( workflow : dewret . workflow . Workflow ) -> 'WorkflowDefinition' Creates a WorkflowDefinition object from a Workflow object. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description str WorkflowDefinition with definited steps. Instance variables steps Methods render def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Render the WorkflowDefinition. Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the Workflow definition, for use in Snakemake workflows.","title":"Snakemake"},{"location":"reference/dewret/renderers/snakemake/#module-dewretrendererssnakemake","text":"Snakemake Renderer. Outputs a Snakemake representation of the current workflow.","title":"Module dewret.renderers.snakemake"},{"location":"reference/dewret/renderers/snakemake/#variables","text":"MainTypes","title":"Variables"},{"location":"reference/dewret/renderers/snakemake/#functions","text":"","title":"Functions"},{"location":"reference/dewret/renderers/snakemake/#get_method_args","text":"def get_method_args ( func : dewret . workflow . Lazy ) -> inspect . Signature Retrieve the argument names and types of a lazy-evaluatable function. Parameters: Name Type Description Default func None A function that adheres to the Lazy protocol. None Returns: Type Description None An ItemsView object containing the argument names and their corresponding inspect.Parameter objects.","title":"get_method_args"},{"location":"reference/dewret/renderers/snakemake/#get_method_rel_path","text":"def get_method_rel_path ( func : dewret . workflow . Lazy ) -> Any Get the relative path of the module containing the given function. Parameters: Name Type Description Default func Lazy The function for which the relative path is to be determined. None Returns: Type Description any The relative path of the module containing the function.","title":"get_method_rel_path"},{"location":"reference/dewret/renderers/snakemake/#raw_render","text":"def raw_render ( workflow : dewret . workflow . Workflow ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Render the workflow as a Snakemake (SMK) string. This function converts a Workflow object into a object containing snakemake rules. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the Workflow definition, for use in Snakemake workflows.","title":"raw_render"},{"location":"reference/dewret/renderers/snakemake/#render","text":"def render ( workflow : dewret . workflow . Workflow ) -> dict [ str , typing . Any ] Render the workflow as a Snakemake (SMK) string. This function converts a Workflow object into a Snakemake-compatible yaml. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description str A Snakemake-compatible yaml representation of the workflow.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#to_snakemake_type","text":"def to_snakemake_type ( param : dewret . core . Raw ) -> str Convert a raw type to a corresponding Snakemake-compatible Python type. This function maps raw types to their corresponding Python types as used in Snakemake. Snakemake primarily uses Python types for its parameters, and this function ensures that the provided type is appropriately converted. Parameters: Name Type Description Default param None The raw type to be converted, which can be of any type. None Returns: Type Description None A string representing the corresponding Python type for Snakemake. Raises: Type Description TypeError If the parameter's type cannot be mapped to a known Python type.","title":"to_snakemake_type"},{"location":"reference/dewret/renderers/snakemake/#classes","text":"","title":"Classes"},{"location":"reference/dewret/renderers/snakemake/#inputdefinition","text":"class InputDefinition ( inputs : list [ str ], params : list [ str ] ) Represents input and parameter definitions block for a Snakemake-renderable workflow step.","title":"InputDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes","text":"Name Type Description Default inputs List[str] A list of input definitions. None params List[str] A list of parameter definitions. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_step","text":"def from_step ( step : dewret . workflow . BaseStep ) -> 'InputDefinition' Constructs an InputDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which input and parameter block definitions are extracted. None Returns: Type Description InputDefinition An InputDefinition object.","title":"from_step"},{"location":"reference/dewret/renderers/snakemake/#instance-variables","text":"inputs params","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_1","text":"def render ( self ) -> dict [ str , list [ str ]] Renders the input and parameter definitions as a dictionary. Returns: Type Description dict[str, list[MainTypes]] A dictionary containing the input and parameter definitions, for use in Snakemake Input and Params blocks.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#outputdefinition","text":"class OutputDefinition ( output_file : str ) Represents the output definition block for a Snakemake-renderable workflow step.","title":"OutputDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes_1","text":"Name Type Description Default output_file str The output file definition. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods_1","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_step_1","text":"def from_step ( step : dewret . workflow . BaseStep ) -> 'OutputDefinition' Constructs an OutputDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which the output file definition is extracted. None Returns: Type Description OutputDefinition An OutputDefinition object, for use in Snakemake Output block.","title":"from_step"},{"location":"reference/dewret/renderers/snakemake/#instance-variables_1","text":"output_file","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods_1","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_2","text":"def render ( self ) -> list [ str ] Renders the output definition as a list. Returns: Type Description list[str] A list containing the output file definition, for use in a Snakemake Output block.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#referencedefinition","text":"class ReferenceDefinition ( source : str ) Represents a Snakemake-renderable internal reference.","title":"ReferenceDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes_2","text":"Name Type Description Default source str The source of the internal reference. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods_2","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_reference","text":"def from_reference ( ref : dewret . core . Reference [ typing . Any ] ) -> 'ReferenceDefinition' Build from a Reference . Converts a dewret.workflow.Reference into a Snakemake-rendering object. Parameters: Name Type Description Default ref None reference to convert. None","title":"from_reference"},{"location":"reference/dewret/renderers/snakemake/#instance-variables_2","text":"source","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods_2","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_3","text":"def render ( self ) -> str Render the internal reference definition as a string. Returns: Type Description str internal reference.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#rundefinition","text":"class RunDefinition ( method_name : str , rel_import : str , args : list [ str ] ) Represents a Snakemake-renderable run block for a dewret workflow step.","title":"RunDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes_3","text":"Name Type Description Default method_name str The name of the method to be executed in the snakefile run block. None rel_import str The relative import path of the method. None args List[str] The arguments to be passed to the method. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods_3","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_task","text":"def from_task ( task : dewret . workflow . Task | dewret . workflow . Workflow ) -> 'RunDefinition' Constructs a RunDefinition object from a Task. Parameters: Name Type Description Default task Task The Task object from which method information and arguments are extracted. None Returns: Type Description RunDefinition A RunDefinition object containing the converted method information and arguments.","title":"from_task"},{"location":"reference/dewret/renderers/snakemake/#instance-variables_3","text":"args method_name rel_import","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods_3","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_4","text":"def render ( self ) -> list [ str ] Renders the run block as a list of strings. Returns: Type Description list[str] A list containing the import statement and the method call statement, for use in Snakemake run block.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#stepdefinition","text":"class StepDefinition ( name : str , run : list [ str ], params : list [ str ], output : list [ str ], input : list [ str ] ) Represents a Snakemake-renderable step definition in a dewret workflow.","title":"StepDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes_4","text":"Name Type Description Default name str The name of the step. None run str The run block definition for the step. None params List[str] The parameter definitions for the step. None output (list[str] None The output definition for the step. None input List[str] The input definitions for the step. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods_4","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_step_2","text":"def from_step ( step : dewret . workflow . BaseStep ) -> 'StepDefinition' Constructs a StepDefinition object from a Step. Parameters: Name Type Description Default step Step The Step object from which step information and components are extracted. None Returns: Type Description StepDefinition A StepDefinition object containing the converted step information and components.","title":"from_step"},{"location":"reference/dewret/renderers/snakemake/#instance-variables_4","text":"input name output params run","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods_4","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_5","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Renders the step definition as a dictionary. Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the step definition, for use in Snakemake workflows.","title":"render"},{"location":"reference/dewret/renderers/snakemake/#workflowdefinition","text":"class WorkflowDefinition ( steps : list [ dewret . renderers . snakemake . StepDefinition ] ) Represents a Snakemake-renderable workflow definition from a dewret workflow.","title":"WorkflowDefinition"},{"location":"reference/dewret/renderers/snakemake/#attributes_5","text":"Name Type Description Default steps List[StepDefinition] A list of StepDefinition objects representing the steps in the workflow. None","title":"Attributes"},{"location":"reference/dewret/renderers/snakemake/#static-methods_5","text":"","title":"Static methods"},{"location":"reference/dewret/renderers/snakemake/#from_workflow","text":"def from_workflow ( workflow : dewret . workflow . Workflow ) -> 'WorkflowDefinition' Creates a WorkflowDefinition object from a Workflow object. Parameters: Name Type Description Default workflow Workflow The workflow to be rendered. None Returns: Type Description str WorkflowDefinition with definited steps.","title":"from_workflow"},{"location":"reference/dewret/renderers/snakemake/#instance-variables_5","text":"steps","title":"Instance variables"},{"location":"reference/dewret/renderers/snakemake/#methods_5","text":"","title":"Methods"},{"location":"reference/dewret/renderers/snakemake/#render_6","text":"def render ( self ) -> dict [ str , str | float | bool | bytes | int | None | list [ str ] | list [ 'MainTypes' ] | dict [ str , 'MainTypes' ]] Render the WorkflowDefinition. Returns: Type Description dict[str, MainTypes] A dictionary containing the components of the Workflow definition, for use in Snakemake workflows.","title":"render"}]} \ No newline at end of file diff --git a/sitemap.xml b/sitemap.xml new file mode 100644 index 00000000..8583ba25 --- /dev/null +++ b/sitemap.xml @@ -0,0 +1,93 @@ + + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + + None + 2025-01-08 + daily + + \ No newline at end of file diff --git a/sitemap.xml.gz b/sitemap.xml.gz new file mode 100644 index 00000000..9d9c9849 Binary files /dev/null and b/sitemap.xml.gz differ