<?xml version="1.0" encoding="utf-8" standalone="yes"?>

<?xml-stylesheet href="./_c74_ref.xsl" type="text/xsl"?>

<!--This is an automatically generated file. DO NOT EDIT THIS FILE DIRECTLY. Rather, use the _ref.xml files found in the 'edits' folder.-->
<c74object name="anal" module="max" category="Data">
	<digest>
		Make a histogram of number pairs
	</digest>
	<description>
		Reports how many times a number pair has been received.
	</description>
	<!--METADATA-->
	<metadatalist>
		<metadata name="author">
			Cycling '74
		</metadata>
		<metadata name="tag">
			Max
		</metadata>
		<metadata name="tag">
			Data
		</metadata>
	</metadatalist>
	<!--INLETS-->
	<inletlist>
		<inlet id="0" type="INLET_TYPE">
			<digest>
				Incoming Number Stream
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
		<inlet id="1" type="INLET_TYPE">
			<digest>
			</digest>
			<description>
				TEXT_HERE
			</description>
		</inlet>
	</inletlist>
	<!--OUTLETS-->
	<outletlist>
		<outlet id="0" type="OUTLET_TYPE">
			<digest>
				Transitions Seen Between Current and Previous
			</digest>
			<description>
				TEXT_HERE
			</description>
		</outlet>
	</outletlist>
	<!--ARGUMENTS-->
	<objarglist>
		<objarg name="input-limit" optional="1" type="int">
			<digest>
				Limit the input values
			</digest>
			<description>
				Sets a maximum limit for the values that can be input into <o>anal</o>. Input values are clipped between zero and this value. The default value, when no argument is present, is 128. By supplying an argument, you can change the maximum input value up to a maximum of 16384.
			</description>
			<discussion>
				The number of different transition probabilities that <o>anal</o> can keep track of is the square of this maximum input value. A maximum input value of 128 represents a table consisting of 16,384 different pairs; when the maximum limit is set to the maximum input value possible of 16384, anal can keep track of a whopping 268,435,456 unique numerical pairs!
			</discussion>
		</objarg>
	</objarglist>
	<!--MESSAGES-->
	<methodlist>
		<method name="int">
			<arglist>
				<arg name="input" optional="0" type="int" />
			</arglist>
			<digest>
				Report numeric frequency
			</digest>
			<description>
				Reports how many times this number and the previously received number have occurred in immediate succession. (The first time a number is received, there has been no previous number, so nothing happens.)
			</description>
		</method>
		<method name="clear">
			<arglist />
			<digest>
				Clear pairing counts
			</digest>
			<description>
				Erases the memory of the <o>anal</o> object entirely, but retains the most recently received number to use as the next &quot;previous&quot; value.
			</description>
		</method>
		<method name="reset">
			<arglist />
			<digest>
				Remove a prior value
			</digest>
			<description>
				Erases the most recently received number from the memory of the <o>anal</o> object. The next number to be received gets stored in its place, to serve as the next &quot;previous&quot; value (but nothing else happens).
			</description>
		</method>
	</methodlist>
	<!--ATTRIBUTES-->
	<!--EXAMPLE-->
	<examplelist>
		<example img="anal.png" caption="Keep track of number pairs and their relative frequency of occurrence pass the information to prob to generate similar transitions" />
	</examplelist>
	<!--SEEALSO-->
	<seealsolist>
		<seealso name="histo" />
		<seealso name="prob" />
	</seealsolist>
	<discussion>
		The output list is designed to serve as input to the <o>prob</o> object, to create a probability matrix of transitions from one number to another (known as a first-order Markov chain).
	</discussion>
	<misc name="Output">
		<entry name="list">
			<description>
				The first two numbers in the list are the two most recently received numbers, and the third number shows how many times that particular succession of two numbers has been received. This list of three numbers is designed to be used as input to the <o>prob</o> object, to create a probability matrix of transitions from one number to another (known as a first-order Markov chain).
			</description>
		</entry>
	</misc>
</c74object>
