Algoritharium

The Algoritharium project at the University of North Carolina Wilmington provides students in a CS1 course in Java an environment where they can focus on algorithms. The package allows students to easily implement image processing algorithms.

This project was supported in part by the National Science Foundation under grant CPATH EAE: texnh - Evaluation, Adoption and Extension, award number 0722313. For more information please contact Jack Tompkins (tompkinsj@uncw.edu) or Sridhar Narayan (narayans@uncw.edu).

World Comp 2010 Paper

See:
A quick tutorial -using Algoritharium libraries

Algoritharium API
API

Algoritharium Package
algoritharium.jar	-compiled with JDK 1.6, latest update: January 24, 2012	-MAC compatibility tips

Notes:

My program runs out of memory, but my system should have more than enough. What's going on? The java heap is the area of RAM reserved for use by the Java virtual machine. The default java heap is determined as follows

initial heap size:: Larger of 1/64th of the machine's physical memory on the machine or some reasonable minimum. Before J2SE 5.0, the default initial heap size was a reasonable minimum, which varies by platform. You can override this default using the -Xms command-line option.
maximum heap size:: Smaller of 1/4th of the physical memory or 1GB. Before J2SE 5.0, the default maximum heap size was 64MB. You can override this default using the -Xmx command-line option.

Specifically ask for more (assuming your system has enough) with the following command:

% java -Xmx300m -Xms300m -jar algoritharium.jar

In this case, we are asking for 300 MB of memory (note no space between the switch and size and correct units are none for bytes, k for kilobytes, m for megabytes, M for megabytes, or g for gigabytes.) The -Xmx sets the maximum heap size, the -Xms flag sets the initial heap size. The operating system determines whether physical ram or paging will be used to achieve the requested memory.

File/Properties -Java Build Path edit JRE System Library, Java Execution Environment pull down menu select

MAC compatibility tips

Apple Computer supplies their own version of Java. Use the Software Update feature (available on the Apple menu) to check that you have the most up-to-date version of Java for your Mac as the Algoritharium requires JDK 1.6.0_29 or later.
Set the JDK version for your Eclipse Workspace so that all new projects use version 1.6 or later:
- Click on the Eclipse menu item "Eclipse" just left of the File menu
  - select Preferences
    - under Java select
      - Compiler
        
        set compiler compliance level to 1.6
      - Also under Java select
        
        Installed JREs and verify the JVM 1.6 or later is the only one checked.
Set the JDK version for an existing project:
- Click on the menu item Project and select Properties
  - under Java Build Path
    - click on the JRE System Library and select edit
    - Use the pull down menu in the Execution environment tab to select JavaSE 1.6 or later.
With the MyImageAlgorithms project selected set its properties to recognize the external jar file algoritharium.jar:
- Click on the menu item Project and select Properties
  - under Java Build Path select Libraries
    - click on the Add External JARs
    - navigate to folder where you have stored the latest version of algoritharium.jar
    - select algoritharium.jar and click OK.
  - under Java Compiler
    - verify the compiler version is 1.6 -use the pulldown menu to change it here if necessary as well as in all the indicated places
import algoritharium.ImageViewer;
public class MyImageAlgorithms {
    public static void main(String[] args) {
        new ImageViewer();
    }

}

free hit counter