ó àÆ÷Xc@`s¿dZddlmZmZmZddlmZddlmZddl m Z ddl Z e j dƒZ d Zd efd „ƒYZd efd „ƒYZdefd„ƒYZeZdS(s9 Define `SymbolicInput`, `SymbolicOutput`, `In`, `Out`. i(tabsolute_importtprint_functiontdivision(tgofi(tSharedVariable(t string_typesNstheano.compile.iosrestructuredtext ent SymbolicInputcB`s>eZdZdddedeed„Zd„Zd„ZRS(s: Represents a symbolic input for use with function or FunctionMaker. Parameters ---------- variable : a Variable instance This will be assigned a value before running the function, not computed from its owner. name : Any type If autoname=True, defaults to variable.name. If name is a valid Python identifier, this input can be set by kwarg, and its value can be accessed by self.. update : Variable instance Defaults to None. Value (see previous) will be replaced with this expression variable after each function call. If update is None, the update will be the default value of the input. mutable : bool Defaults to False if update is None, True if update is not None. True: permit the compiled function to modify the python object being passed as the input. False: do not permit the compiled function to modify the python object being passed as the input. strict : bool Defaults to False. True: means that the value you pass for this input must have exactly the right type. False: the value you pass for this input may be cast automatically to the proper type. allow_downcast : bool or None Defaults to None. Only applies when `strict` is False. True: the value you pass for this input can be silently downcasted to fit the right type, which may lose precision. False: the value will only be cast to a more general, or precise, type. None: Almost like False, but allows downcast of Python floats to floatX. autoname : bool Defaults to True. See the name option. implicit : bool Defaults to False. See help(In). Note that 'None' is not allowed here, since we are in the symbolic case. c C`s|dk st‚||_|r<|dkr<|j|_n ||_|jdk r}t|jtƒ r}td|jƒ‚n||_|dk rÉ|j|jksÉtd||j|jfƒ‚qÉn|dk rá||_ n|dk |_ ||_ ||_ ||_ dS(Ns name must be a string! (got: %s)syVariable '%s' has type %s but an update of type %s. The type of the update should be the same as the type of the variable( tNonetAssertionErrortvariabletnamet isinstanceRt TypeErrortupdatettypetmutabletstricttallow_downcasttimplicit( tselfR R R RRRtautonameR((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyt__init__=s$  "      cC`s,|jrd|j|jfSd|jSdS(Ns In(%s -> %s)sIn(%s)(R R (R((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyt__str__Zs cC`s t|ƒS(N(tstr(R((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyt__repr__`sN( t__name__t __module__t__doc__RtFalsetTrueRRR(((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyRs )    tInc B`s5eZdZddddededded„ ZRS(sc Represents a symbolic input for use with function or FunctionMaker. Parameters ---------- variable : a Variable instance This will be assigned a value before running the function, not computed from its owner. name : Any type If autoname=True, defaults to variable.name. If name is a valid Python identifier, this input can be set by kwarg, and its value can be accessed by self.. value : Any type The initial/default value for this input. If update is None, this input acts just like an argument with a default value in Python. If update is not None, changes to this value will "stick around", whether due to an update or a user's explicit action. update : Variable instance Defaults to None. Value (see previous) will be replaced with this expression variable after each function call. If update is None, the update will be the default value of the input. mutable : bool Defaults to False if update is None, True if update is not None. True: permit the compiled function to modify the python object being passed as the input. False: do not permit the compiled function to modify the python object being passed as the input. borrow : bool Default : take the same value as mutable. True: permit the output of the compiled function to be aliased to the input. False: do not permit any output to be aliased to the input. strict : bool Defaults to False. True: means that the value you pass for this input must have exactly the right type. False: the value you pass for this input may be cast automatically to the proper type. allow_downcast : bool or None Defaults to None. Only applies when `strict` is False. True: the value you pass for this input can be silently downcasted to fit the right type, which may lose precision. False: the value will only be cast to a more general, or precise, type. None: Almost like False, but allows downcast of Python floats to floatX. autoname : bool Defaults to True. See the name option. implicit : bool or None Defaults to None. True: This input is implicit in the sense that the user is not allowed to provide a value for it. Requires 'value' to be set. False: The user can provide a value for this input. Be careful when 'value' is a container, because providing an input value will overwrite the content of this container. None: Automatically choose between True or False depending on the situation. It will be set to False in all cases except if 'value' is a container (so that there is less risk of accidentally overwriting its content without being aware of it). c C`só| |_| dkr!||_n | |_|rO|j rOtd||ƒ‚n| dkrt|tjƒpyt|tƒ} ntt |ƒj d|d|d|d|d|d|d|d | ƒ||_ |j rï|dkrït d ƒ‚ndS( NsÕSymbolic input for variable %s (name=%s) has flags mutable=True, borrow=False. This combination is incompatible since mutable=True implies that the input variable may be both aliased (borrow=True) and overwritten.R R R RRRRRs/An implicit input must be given a default value(tsharedRtborrowRR Rt ContainerRtsuperRRtvalueRR ( RR R R#R RRRRRR R((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyR£s.      N(RRRRRRR(((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyRds<  tSymbolicOutputcB`s,eZdZed„Zd„Zd„ZRS(ss Represents a symbolic output for use with function or FunctionMaker. Parameters ---------- borrow : bool Set this to True to indicate that a reference to function's internal storage may be returned. A value returned for this output might be clobbered by running the function again, but the function might be faster. cC`s||_||_dS(N(R R (RR R ((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyRÛs cC`sd|j|jfS(Ns Out(%s,%s)(R R (R((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyRßscC`sd|j|jfS(Ns Out(%s,%s)(R R (R((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyRâs(RRRRRRR(((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyR$Ís   (Rt __future__RRRttheanoRt sharedvalueRtsixRtloggingt getLoggert_loggert __docformat__tobjectRRR$tOut(((s1/tmp/pip-build-X4mzal/theano/theano/compile/io.pyts Ri