o
    ed                  	   @  s   d Z ddlmZ ddlmZ ddlmZmZmZm	Z	 ddl
mZ ddlmZ ddlmZ ddlmZmZ dd	lmZ g d
Zi dddddddddddddddddddddd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4ZG d5d6 d6eZd<d8d9Zd:d; Zd7S )=ai  
Octave (and Matlab) code printer

The `OctaveCodePrinter` converts SymPy expressions into Octave expressions.
It uses a subset of the Octave language for Matlab compatibility.

A complete code generator, which uses `octave_code` extensively, can be found
in `sympy.utilities.codegen`.  The `codegen` module can be used to generate
complete source code files.

    )annotations)Any)MulPowSRational)_keep_coeff)equal_valued)CodePrinter)
precedence
PRECEDENCEsearch)1sincostanZcotsecZcscasinacosZacotatanatan2ZasecZacscsinhcoshtanhZcothZcschZsechasinhacoshatanhZacothZasechZacscherfcZerfierfZerfinvZerfcinvZbesselibesseljZbesselkbesselyZ	bernoullibetaZeulerexp	factorialfloorZfresnelcZfresnelsgammaZharmoniclogZpolylogsignzetaZlegendreZAbsabsargZangleZbinomialZbincoeffZceilingceilZ
chebyshevuZ
chebyshevUZ
chebyshevtZ
chebyshevTChiZcoshintZCiZcosint	conjugateZconjZ
DiracDeltaZdiracZ	HeavisideZ	heavisideZimimagZlaguerreZ	laguerreLZLambertWZlambertwZliZlogintZloggammaZgammalnZMaxmaxminmodpsirealZ
pochhammerZsinhintZsinint)ZMinModZ	polygammareZRisingFactorialZShiZSic                	      s  e Zd ZU dZdZdZddddZdd	d
i dddddZded< i f fdd	Z	dd Z
dd Zdd Zdd Zdd Zdd Zdd Zd d! Zd"d# Zd$d% Zd&d' Zd(d) Zd*d+ Zd,d- Zd.d/ Zd0d1 Zd2d3 Zd4d5 Zd6d7 Zd8d9 Zd:d; ZeZeZ eZ!d<d= Z"d>d? Z#d@dA Z$dBdC Z%dDdE Z&dFdG Z'dHdI Z(dJdK Z)dLdM Z*dNdO Z+dPdQ Z,dRdS Z-dTdU Z.dVdW Z/dXdY Z0dZd[ Z1d\d] Z2d^d_ Z3d`da Z4dbdc Z5ddde Z6dfdg Z7dhdi Z8djdk Z9dldm Z:dndo Z;e; Z<Z=dpdq Z>e> Z?Z@drds ZAdtdu ZBdvdw ZC  ZDS )xOctaveCodePrinterzL
    A printer to convert expressions to strings of Octave/Matlab code.
    Z_octaveOctave&|~)andornotNauto   TF)orderZ	full_prec	precisionuser_functionsZhumanZallow_unknown_functionscontractinlinezdict[str, Any]_default_settingsc                   sH   t  | tttt| _| jtt |di }| j| d S )NrB   )	super__init__dictzipknown_fcns_src1known_functionsupdateknown_fcns_src2get)selfsettingsZ	userfuncs	__class__ ED:\Projects\ConvertPro\env\Lib\site-packages\sympy/printing/octave.pyrG   ]   s
   zOctaveCodePrinter.__init__c                 C  s   |d S )N   rS   )rO   prS   rS   rT   _rate_index_positione      z&OctaveCodePrinter._rate_index_positionc                 C  s   d| S )Nz%s;rS   )rO   Z
codestringrS   rS   rT   _get_statementi   rX   z OctaveCodePrinter._get_statementc                 C  s
   d |S )Nz% {}format)rO   textrS   rS   rT   _get_commentm      
zOctaveCodePrinter._get_commentc                 C  s   d ||S )Nz{} = {};rZ   )rO   namevaluerS   rS   rT   _declare_number_constq      z'OctaveCodePrinter._declare_number_constc                 C  s
   |  |S N)indent_code)rO   linesrS   rS   rT   _format_codeu   r^   zOctaveCodePrinter._format_codec                   s    |j \ } fddt|D S )Nc                 3  s&    | ]}t  D ]}||fV  qqd S rc   )range).0jirowsrS   rT   	<genexpr>|   s   $ z=OctaveCodePrinter._traverse_matrix_indices.<locals>.<genexpr>)shaperg   )rO   matcolsrS   rk   rT   _traverse_matrix_indicesy   s   
z*OctaveCodePrinter._traverse_matrix_indicesc                 C  s^   g }g }|D ]$}t | j|j|jd |jd g\}}}|d|||f  |d q||fS )N   zfor %s = %s:%send)map_printlabellowerupperappend)rO   indicesZ
open_linesZclose_linesrj   varstartstoprS   rS   rT   _get_loop_opening_ending   s   
z*OctaveCodePrinter._get_loop_opening_endingc                   sb  |j r|jrtj| jrdtj |  S t| | \}}|dk r.t| |}d}nd}g }g }g }j	dvr@|
 }nt|}|D ]l}	|	jr|	jr|	jjr|	jjr|	jdkrj|t|	j|	j dd qGt|	jd jd	krt|	jtr||	 |t|	j|	j  qG|	jr|	tjur|	jd	kr|t|	j |	jd	kr|t|	j qG||	 qG|ptjg} fd
d|D }
 fdd|D }|D ]}	|	j|v rd|||	j  |||	j< qdd }|s||||
 S t|d	kr|d j rdnd}||||
 | |d  S tdd |D rdnd}||||
 | d|||  S )Nz%sir   - )oldnoneF)evaluaterr   c                      g | ]} | qS rS   parenthesizerh   xprecrO   rS   rT   
<listcomp>       z0OctaveCodePrinter._print_Mul.<locals>.<listcomp>c                   r   rS   r   r   r   rS   rT   r      r   z(%s)c                 S  sF   |d }t dt| D ]}| |d  jrdnd}|| ||  }q|S )Nr   rr   *.*)rg   len	is_number)aa_strrrj   ZmulsymrS   rS   rT   multjoin   s
   z.OctaveCodePrinter._print_Mul.<locals>.multjoin/./c                 s      | ]}|j V  qd S rc   r   )rh   ZbirS   rS   rT   rm          z/OctaveCodePrinter._print_Mul.<locals>.<genexpr>)r   Zis_imaginaryr   ZImaginaryUnitZ
is_Integerru   r   Zas_coeff_Mulr   r@   Zas_ordered_factorsr   Z	make_argsis_commutativeZis_Powr"   Zis_RationalZis_negativery   r   baser   args
isinstanceInfinityrV   r   qZOneindexall)rO   exprcer'   r   bZ	pow_parenr   itemr   Zb_strr   ZdivsymrS   r   rT   
_print_Mul   sf   




 



 zOctaveCodePrinter._print_Mulc                 C  s,   |  |j}|  |j}|j}d|||S )Nz{} {} {})ru   lhsrhsZrel_opr[   )rO   r   lhs_coderhs_codeoprS   rS   rT   _print_Relational   s   z#OctaveCodePrinter._print_Relationalc                 C  s   t dd |jD rdnd}t|}t|jdr d| |j S |jrXt|jdr=|jjr/dnd	}d
| d| |j  S t|jdrX|jjrIdnd	}d
| d| 	|j|  S d| 	|j||| 	|j|f S )Nc                 s  r   rc   r   r   rS   rS   rT   rm      r   z/OctaveCodePrinter._print_Pow.<locals>.<genexpr>^z.^g      ?zsqrt(%s)g      r   r   1r   %sz%s%s%s)
r   r   r   r	   r"   ru   r   r   r   r   )rO   r   Z	powsymbolPRECsymrS   rS   rT   
_print_Pow   s   zOctaveCodePrinter._print_Powc                 C  (   t |}d| |j|| |j|f S )Nz%s^%s)r   r   r   r"   rO   r   r   rS   rS   rT   _print_MatPow      zOctaveCodePrinter._print_MatPowc                 C  r   )Nz%s \ %s)r   r   matrixZvectorr   rS   rS   rT   _print_MatrixSolve   r   z$OctaveCodePrinter._print_MatrixSolvec                 C     dS )NpirS   rO   r   rS   rS   rT   	_print_Pi      zOctaveCodePrinter._print_Pic                 C  r   )NZ1irS   r   rS   rS   rT   _print_ImaginaryUnit   r   z&OctaveCodePrinter._print_ImaginaryUnitc                 C  r   )Nzexp(1)rS   r   rS   rS   rT   _print_Exp1  r   zOctaveCodePrinter._print_Exp1c                 C  r   )Nz(1+sqrt(5))/2rS   r   rS   rS   rT   _print_GoldenRatio  s   z$OctaveCodePrinter._print_GoldenRatioc                 C  s   ddl m} ddlm} ddlm} |j}|j}| jd sHt	|j|rHg }g }|j
D ]\}	}
||||	 ||
 q*|t|| }| |S | jd r]||sW||r]| ||S | |}| |}| d||f S )Nr   )
Assignment)	Piecewise)IndexedBaserD   rC   z%s = %s)Zsympy.codegen.astr   Z$sympy.functions.elementary.piecewiser   Zsympy.tensor.indexedr   r   r   	_settingsr   r   ry   rI   ru   hasZ_doprint_loopsrY   )rO   r   r   r   r   r   r   ZexpressionsZ
conditionsr   r   tempr   r   rS   rS   rT   _print_Assignment  s(   


z#OctaveCodePrinter._print_Assignmentc                 C  r   )NinfrS   r   rS   rS   rT   _print_Infinity(  r   z!OctaveCodePrinter._print_Infinityc                 C  r   )Nz-infrS   r   rS   rS   rT   _print_NegativeInfinity,  r   z)OctaveCodePrinter._print_NegativeInfinityc                 C  r   )NNaNrS   r   rS   rS   rT   
_print_NaN0  r   zOctaveCodePrinter._print_NaNc                   s    dd  fdd|D  d S )N{, c                 3      | ]}  |V  qd S rc   ru   rh   r   rO   rS   rT   rm   5      z0OctaveCodePrinter._print_list.<locals>.<genexpr>}joinr   rS   r   rT   _print_list4  s    zOctaveCodePrinter._print_listc                 C  r   )NtruerS   r   rS   rS   rT   _print_BooleanTrue;  r   z$OctaveCodePrinter._print_BooleanTruec                 C  r   )NfalserS   r   rS   rS   rT   _print_BooleanFalse?  r   z%OctaveCodePrinter._print_BooleanFalsec                 C  s   t | S rc   )strrw   r   rS   rS   rT   _print_boolC  rb   zOctaveCodePrinter._print_boolc                   sr    j  jfdkr
dS tj jv rd j  jf S  j  jfdkr' d S dd fddt j D  S )	N)r   r   z[]zzeros(%s, %s))rr   rr   z[%s]z; c                 3  s4    | ]}d  fdd |ddf D V  qdS ) c                      g | ]}  |qS rS   r   r   r   rS   rT   r   T      zAOctaveCodePrinter._print_MatrixBase.<locals>.<genexpr>.<listcomp>Nr   )rh   r   ArO   rS   rT   rm   T  s    ,z6OctaveCodePrinter._print_MatrixBase.<locals>.<genexpr>)rl   rp   r   ZZerorn   ru   r   rg   )rO   r   rS   r   rT   _print_MatrixBaseK  s   
z#OctaveCodePrinter._print_MatrixBasec                 C  sx   ddl m} | }|dd |D g}|dd |D g}|dd |D g}d| || || ||j|jf S )Nr   )Matrixc                 S  s   g | ]}|d  d qS )r   rr   rS   rh   krS   rS   rT   r   \  r   z<OctaveCodePrinter._print_SparseRepMatrix.<locals>.<listcomp>c                 S  s   g | ]}|d  d  qS )rr   rS   r   rS   rS   rT   r   ]  r   c                 S  s   g | ]}|d  qS )   rS   r   rS   rS   rT   r   ^  s    zsparse(%s, %s, %s, %s, %s))Zsympy.matricesr   Zcol_listru   rl   rp   )rO   r   r   LIJZAIJrS   rS   rT   _print_SparseRepMatrixX  s   z(OctaveCodePrinter._print_SparseRepMatrixc                 C  s.   | j |jtd ddd|jd |jd f  S )NZAtomT)strictz(%s, %s)rr   )r   parentr   rj   ri   r   rS   rS   rT   _print_MatrixElementc  s   z&OctaveCodePrinter._print_MatrixElementc                   sL    fdd}  |jd ||j|jjd  d ||j|jjd  d S )Nc                   s   | d d }| d }| d }  |}||krdn  |}|dkr8|dkr,||kr,dS ||kr2|S |d | S d|  ||fS )Nr   rr   r   rs   :)ru   r   )r   ZlimlhstepZlstrZhstrr   rS   rT   strslicei  s   
z6OctaveCodePrinter._print_MatrixSlice.<locals>.strslice(r   r   rr   ))ru   r   Zrowslicern   Zcolslice)rO   r   r   rS   r   rT   _print_MatrixSliceh  s   z$OctaveCodePrinter._print_MatrixSlicec                   s0    fdd|j D }d |jjd|f S )Nc                   r   rS   r   )rh   rj   r   rS   rT   r   ~  r   z4OctaveCodePrinter._print_Indexed.<locals>.<listcomp>z%s(%s)r   )rz   ru   r   rv   r   )rO   r   ZindsrS   r   rT   _print_Indexed}  s   z OctaveCodePrinter._print_Indexedc                 C  s   |  |jS rc   )ru   rv   r   rS   rS   rT   
_print_Idx  rb   zOctaveCodePrinter._print_Idxc                   s&   t d  dt fdd|jD  S )Nr   zdouble(%s == %s)c                 3  s    | ]	} | V  qd S rc   r   r   r   rS   rT   rm     s    z:OctaveCodePrinter._print_KroneckerDelta.<locals>.<genexpr>)r   tupler   r   rS   r   rT   _print_KroneckerDelta  s   
z'OctaveCodePrinter._print_KroneckerDeltac                   s   d  fdd jD S )Nr   c                   s   g | ]
} |t qS rS   )r   r   )rh   r*   r   rO   rS   rT   r     s    z<OctaveCodePrinter._print_HadamardProduct.<locals>.<listcomp>)r   r   r   rS   r   rT   _print_HadamardProduct  s   z(OctaveCodePrinter._print_HadamardProductc                 C  s*   t |}d| |j|| |j|gS )Nz.**)r   r   r   r   r"   r   rS   rS   rT   _print_HadamardPower  s
   z&OctaveCodePrinter._print_HadamardPowerc                   sP   |j }t|dkr|d |d kr|d g}d fdd|D }d| d S )	Nr   r   rr   r   c                 3  r   rc   r   )rh   nr   rS   rT   rm     r   z4OctaveCodePrinter._print_Identity.<locals>.<genexpr>zeye(r   )rn   r   r   )rO   r   rn   srS   r   rT   _print_Identity  s
   
z!OctaveCodePrinter._print_Identityc                 C  $   d | |jd | |jd S )Nz (gammainc({1}, {0}).*gamma({0}))r   rr   r[   ru   r   r   rS   rS   rT   _print_lowergamma  s   z#OctaveCodePrinter._print_lowergammac                 C  r  )Nz)(gammainc({1}, {0}, 'upper').*gamma({0}))r   rr   r  r   rS   rS   rT   _print_uppergamma  s   z#OctaveCodePrinter._print_uppergammac                 C  s   d|  |jd tj  S )Nzsinc(%s)r   )ru   r   r   Pir   rS   rS   rT   _print_sinc  s   zOctaveCodePrinter._print_sincc                 C     d|  |j|  |jf S )Nzbesselh(%s, 1, %s)ru   r@   argumentr   rS   rS   rT   _print_hankel1     
z OctaveCodePrinter._print_hankel1c                 C  r	  )Nzbesselh(%s, 2, %s)r
  r   rS   rS   rT   _print_hankel2  r  z OctaveCodePrinter._print_hankel2c                 C  D   ddl m}m} |j}|tjd|  ||jtj | }| |S )Nr   )sqrtr   r   )	sympy.functionsr  r   r  r   r  r@   Halfru   )rO   r   r  r   r   expr2rS   rS   rT   	_print_jn     $
zOctaveCodePrinter._print_jnc                 C  r  )Nr   )r  r    r   )	r  r  r    r  r   r  r@   r  ru   )rO   r   r  r    r   r  rS   rS   rT   	_print_yn  r  zOctaveCodePrinter._print_ync                 C     d|  |jd  S )Nzairy(0, %s)r   ru   r   r   rS   rS   rT   _print_airyai     zOctaveCodePrinter._print_airyaic                 C  r  )Nzairy(1, %s)r   r  r   rS   rS   rT   _print_airyaiprime  r  z$OctaveCodePrinter._print_airyaiprimec                 C  r  )Nzairy(2, %s)r   r  r   rS   rS   rT   _print_airybi  r  zOctaveCodePrinter._print_airybic                 C  r  )Nzairy(3, %s)r   r  r   rS   rS   rT   _print_airybiprime  r  z$OctaveCodePrinter._print_airybiprimec                 C  s*   |j \}}|dkr| |S d| | S )Nrr   z
expint(%s))r   _print_not_supportedru   )rO   r   mur   rS   rS   rT   _print_expint  s   

zOctaveCodePrinter._print_expintc                   sD   t |jdks	J dj j|jj d fddt|jD dS )Nr   z{name}({args})r   c                   r   rS   r   r   r   rS   rT   r     r   z?OctaveCodePrinter._one_or_two_reversed_args.<locals>.<listcomp>)r_   r   )r   r   r[   rK   rR   __name__r   reversedr   rS   r   rT   _one_or_two_reversed_args  s
   z+OctaveCodePrinter._one_or_two_reversed_argsc              	   C  s<   dj | j|jj | |jd | |j|jdd   dS )Nz{name}({arg1}, {arg2})r   rr   )r_   Zarg1Zarg2)r[   rK   rR   r!  ru   r   funcr   rS   rS   rT   _nested_binary_math_func  s
   z*OctaveCodePrinter._nested_binary_math_funcc           
        s(  |j d jdkrtdg } jd r? fdd|j d d D }d |j d j }d|| d	t|  }d
| d	 S t|j D ]J\}\}}|dkrY|	d |  n|t|j d krl|dkrl|	d n
|	d |   |}	|	|	 |t|j d kr|	d qDd|S )Nr   TzAll Piecewise expressions must contain an (expr, True) statement to be used as a default condition. Without one, the generated expression may not evaluate to anything under some condition.rD   c                   s(   g | ]\}}d   | |qS )z({0}).*({1}) + (~({0})).*()r[   ru   )rh   r   r   r   rS   rT   r      s
    z6OctaveCodePrinter._print_Piecewise.<locals>.<listcomp>r   z ...
r   r   r   zif (%s)rr   elsezelseif (%s)rs   
)
r   Zcond
ValueErrorr   ru   r   r   r   	enumeratery   )
rO   r   re   ZecpairsZelastpwrj   r   r   Zcode0rS   r   rT   _print_Piecewise  s,   





z"OctaveCodePrinter._print_Piecewisec                 C  s,   t |jdkrd| |jd  S | |S )Nrr   zzeta(%s)r   )r   r   ru   r  r   rS   rS   rT   _print_zeta  s   
zOctaveCodePrinter._print_zetac           
        s   t |tr| |d}d|S d}dd dd |D }fdd|D } fd	d|D }g }d
}t|D ]%\}}	|	dv rG||	 q9||| 8 }|d|| |	f  ||| 7 }q9|S )z0Accepts a string of code or a list of code linesTr   z  )z
^function z^if ^elseif ^else$z^for )z^end$r-  r.  c                 S  s   g | ]}| d qS )z 	)lstrip)rh   linerS   rS   rT   r   ,  r   z1OctaveCodePrinter.indent_code.<locals>.<listcomp>c                   &   g | ] t t fd dD qS )c                 3      | ]}t | V  qd S rc   r   rh   r5   r0  rS   rT   rm   .  r   ;OctaveCodePrinter.indent_code.<locals>.<listcomp>.<genexpr>intanyrh   )	inc_regexr4  rT   r   .      c                   r1  )c                 3  r2  rc   r   r3  r4  rS   rT   rm   0  r   r5  r6  r9  )	dec_regexr4  rT   r   0  r;  r   )r   r'  z%s%s)r   r   rd   
splitlinesr   r)  ry   )
rO   codeZ
code_linestabZincreaseZdecreaseprettylevelr   r0  rS   )r<  r:  rT   rd     s.   




zOctaveCodePrinter.indent_code)Er!  
__module____qualname____doc__Zprintmethodlanguage
_operatorsrE   __annotations__rG   rW   rY   r]   ra   rf   rq   r~   r   r   r   r   r   r   r   r   r   r   r   r   r   r   Z_print_tupleZ_print_TupleZ_print_Listr   r   r   r   r   r   r   r   r   r   r   r   r  r  r  r  r  r  r  r  r  r  r  r  r   r#  Z_print_DiracDeltaZ_print_LambertWr%  Z
_print_MaxZ
_print_Minr+  r,  rd   __classcell__rS   rS   rQ   rT   r6   A   s   
 J%r6   Nc                 K  s   t || |S )a  Converts `expr` to a string of Octave (or Matlab) code.

    The string uses a subset of the Octave language for Matlab compatibility.

    Parameters
    ==========

    expr : Expr
        A SymPy expression to be converted.
    assign_to : optional
        When given, the argument is used as the name of the variable to which
        the expression is assigned.  Can be a string, ``Symbol``,
        ``MatrixSymbol``, or ``Indexed`` type.  This can be helpful for
        expressions that generate multi-line statements.
    precision : integer, optional
        The precision for numbers such as pi  [default=16].
    user_functions : dict, optional
        A dictionary where keys are ``FunctionClass`` instances and values are
        their string representations.  Alternatively, the dictionary value can
        be a list of tuples i.e. [(argument_test, cfunction_string)].  See
        below for examples.
    human : bool, optional
        If True, the result is a single string that may contain some constant
        declarations for the number symbols.  If False, the same information is
        returned in a tuple of (symbols_to_declare, not_supported_functions,
        code_text).  [default=True].
    contract: bool, optional
        If True, ``Indexed`` instances are assumed to obey tensor contraction
        rules and the corresponding nested loops over indices are generated.
        Setting contract=False will not generate loops, instead the user is
        responsible to provide values for the indices in the code.
        [default=True].
    inline: bool, optional
        If True, we try to create single-statement code instead of multiple
        statements.  [default=True].

    Examples
    ========

    >>> from sympy import octave_code, symbols, sin, pi
    >>> x = symbols('x')
    >>> octave_code(sin(x).series(x).removeO())
    'x.^5/120 - x.^3/6 + x'

    >>> from sympy import Rational, ceiling
    >>> x, y, tau = symbols("x, y, tau")
    >>> octave_code((2*tau)**Rational(7, 2))
    '8*sqrt(2)*tau.^(7/2)'

    Note that element-wise (Hadamard) operations are used by default between
    symbols.  This is because its very common in Octave to write "vectorized"
    code.  It is harmless if the values are scalars.

    >>> octave_code(sin(pi*x*y), assign_to="s")
    's = sin(pi*x.*y);'

    If you need a matrix product "*" or matrix power "^", you can specify the
    symbol as a ``MatrixSymbol``.

    >>> from sympy import Symbol, MatrixSymbol
    >>> n = Symbol('n', integer=True, positive=True)
    >>> A = MatrixSymbol('A', n, n)
    >>> octave_code(3*pi*A**3)
    '(3*pi)*A^3'

    This class uses several rules to decide which symbol to use a product.
    Pure numbers use "*", Symbols use ".*" and MatrixSymbols use "*".
    A HadamardProduct can be used to specify componentwise multiplication ".*"
    of two MatrixSymbols.  There is currently there is no easy way to specify
    scalar symbols, so sometimes the code might have some minor cosmetic
    issues.  For example, suppose x and y are scalars and A is a Matrix, then
    while a human programmer might write "(x^2*y)*A^3", we generate:

    >>> octave_code(x**2*y*A**3)
    '(x.^2.*y)*A^3'

    Matrices are supported using Octave inline notation.  When using
    ``assign_to`` with matrices, the name can be specified either as a string
    or as a ``MatrixSymbol``.  The dimensions must align in the latter case.

    >>> from sympy import Matrix, MatrixSymbol
    >>> mat = Matrix([[x**2, sin(x), ceiling(x)]])
    >>> octave_code(mat, assign_to='A')
    'A = [x.^2 sin(x) ceil(x)];'

    ``Piecewise`` expressions are implemented with logical masking by default.
    Alternatively, you can pass "inline=False" to use if-else conditionals.
    Note that if the ``Piecewise`` lacks a default term, represented by
    ``(expr, True)`` then an error will be thrown.  This is to prevent
    generating an expression that may not evaluate to anything.

    >>> from sympy import Piecewise
    >>> pw = Piecewise((x + 1, x > 0), (x, True))
    >>> octave_code(pw, assign_to=tau)
    'tau = ((x > 0).*(x + 1) + (~(x > 0)).*(x));'

    Note that any expression that can be generated normally can also exist
    inside a Matrix:

    >>> mat = Matrix([[x**2, pw, sin(x)]])
    >>> octave_code(mat, assign_to='A')
    'A = [x.^2 ((x > 0).*(x + 1) + (~(x > 0)).*(x)) sin(x)];'

    Custom printing can be defined for certain types by passing a dictionary of
    "type" : "function" to the ``user_functions`` kwarg.  Alternatively, the
    dictionary value can be a list of tuples i.e., [(argument_test,
    cfunction_string)].  This can be used to call a custom Octave function.

    >>> from sympy import Function
    >>> f = Function('f')
    >>> g = Function('g')
    >>> custom_functions = {
    ...   "f": "existing_octave_fcn",
    ...   "g": [(lambda x: x.is_Matrix, "my_mat_fcn"),
    ...         (lambda x: not x.is_Matrix, "my_fcn")]
    ... }
    >>> mat = Matrix([[1, x]])
    >>> octave_code(f(x) + g(x) + g(mat), user_functions=custom_functions)
    'existing_octave_fcn(x) + my_fcn(x) + my_mat_fcn([1 x])'

    Support for loops is provided through ``Indexed`` types. With
    ``contract=True`` these expressions will be turned into loops, whereas
    ``contract=False`` will just print the assignment expression that should be
    looped over:

    >>> from sympy import Eq, IndexedBase, Idx
    >>> len_y = 5
    >>> y = IndexedBase('y', shape=(len_y,))
    >>> t = IndexedBase('t', shape=(len_y,))
    >>> Dy = IndexedBase('Dy', shape=(len_y-1,))
    >>> i = Idx('i', len_y-1)
    >>> e = Eq(Dy[i], (y[i+1]-y[i])/(t[i+1]-t[i]))
    >>> octave_code(e.rhs, assign_to=e.lhs, contract=False)
    'Dy(i) = (y(i + 1) - y(i))./(t(i + 1) - t(i));'
    )r6   Zdoprint)r   Z	assign_torP   rS   rS   rT   octave_code?  s    	rI  c                 K  s   t t| fi | dS )zPrints the Octave (or Matlab) representation of the given expression.

    See `octave_code` for the meaning of the optional arguments.
    N)printrI  )r   rP   rS   rS   rT   print_octave_code  s   rK  rc   )rD  
__future__r   typingr   Z
sympy.corer   r   r   r   Zsympy.core.mulr   Zsympy.core.numbersr	   Zsympy.printing.codeprinterr
   Zsympy.printing.precedencer   r   r5   r   rJ   rM   r6   rI  rK  rS   rS   rS   rT   <module>   sz    	
    
 