Downloading, installing, and running AM::Parallel (non-PC)

 

To download and install the most recent version of the analogical modeling (AM) program on a Unix/Linux/Mac OS X machine do the following:

  1. Make sure you have ActivePerl installed. You can get it free from this website.
     
  2. Download and save this tarball of AM source code.
     
  3. Install the package by following the instructions in the readme file in the source code.
     
  4. There are three ways to get information on the program and how to use it:

    If you have ActivePerl on your machine, run the Documentation program from the Start Menu under ActivePerl. Then in the left-hand window scroll down about half-way until you see a Modules entry with an AM subentry. Click on Parallel.

    Open a browser to the file C:\Perl\html\site\lib\AM\Parallel.html.

    Open a Command Prompt window and enter:  perldoc AM::Parallel

To install a sample file that shows how you can run the program on the Finnish verb data, do the following:

  1. Make a home folder to run the program in (e.g. C:\amruns or perhaps a new folder called amruns on your Desktop).
     
  2. Download into the home folder this sample perl file called finnverb.pl.
     
  3. Inside the home folder create another folder (the project folder) called finnverb. Into this new project folder download this sample file called data and this sample file called test. Make sure your browser doesn't add a filename extension like .txt to the end of the filename. If it does, rename the file to get rid of the extension.

Now click on the file finnverb.pl in the home folder. The program should run and create an output file called amcpresults in the project folder. You can open this folder in WordPad or your favorite text editor or browser to see the result.

Each project's files should be in its own project folder, and each project should have its own .pl Perl file for running the program. At the very least, for other projects you need to change the project name in the .pl command file on the command that looks like this:

$p = AM::Parallel->new('finnverb', -commas => 'no', -given => 'exclude');

 This command is also where several other parameters are specified (e.g. whether to exclude the givens); for further details consult the documentation mentioned above.