=head1 NAME

Math::Mathematica - A Simple PTY connection to Wolfram's Mathematica

=head1 SYNOPSIS

 use Math::Mathematica;
 my $math = Math::Mathematica->new;
 my $result = $math->evaluate('Integrate[Sin[x],{x,0,Pi}]'); # 2

=head1 DESCRIPTION

Although there are more clever mechanisms to interact with Wolfram's Mathematica (namely MathLink) they are very hard to write. L<Math::Mathematica> simply starts a PTY, runs the command line C<math> program, and manages input/output via string transport. While a MathLink client for Perl would be ideal, this module gets the job done.

This module does not contain a Mathematica interpreter. Mathematica must be installed on the computer before installing/using L<Math::Mathematica>.

=head1 METHODS

=head2 new

Constructor method. Takes hash or hashreference of options:

=over 

=item *

log - If set to a true value (true by default), the full log will be available via the C<log> method.

=item *

command - The command to invoke to start the Mathematica interpreter. The default is C<math> or the value of C<PERL_MATHEMATICA_EXECUTABLE> in your environment.

=item *

warn_after - Number of seconds to wait before warning when waiting for a response from the Mathematica interpreter. After this time, a warning is issued, which one might want to trap.

=item *

pty - An L<IO::Pty::Easy> object (or one which satisfies its api). If this is not specified, one will be created.

=item *

debug - If set to true (or if C<PERL_MATHEMATICA_DEBUG> environment variable is true) then some debug statements are printed to C<STDERR>.

=back

=head2 evaluate

Takes a string to pass to the Mathematica interpreter for evaluation. Returns a string of results. Prompt makers are stripped from the result.

=head2 log

If the C<log> constructor option was set, this accessor will contain the full I/O log of the PTY connection, including Mathematica prompts.

=head2 pty

Accessor method which returns the active L<IO::Pty::Easy> object. This object will be closed when the L<Math::Mathematica> object is destroyed.

=head1 SEE ALSO

=over

=item L<IO::Pty::Easy>

=item L<IO::Pty>

=back

=head1 SOURCE REPOSITORY

L<http://github.com/jberger/Math-Mathematica>

=head1 AUTHOR

Joel Berger, E<lt>joel.a.berger@gmail.comE<gt>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2012 by Joel Berger

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.

Mathematica, MathLink and Wolfram are trademarks of Wolfram Research, Inc. L<http://www.wolfram.com>