SCALAble SimulaTION - ScalaTion

Papers | Scaladoc | Source Code

Welcome to ScalaTion, the Scala-based system for Simulation, Optimization and Analytics.

This system, coded in Scala, supports multi-paradigm simulation modeling including 'tableau', 'event', 'process', 'dynamics', 'dynamics_pde', 'activity' and 'state' oriented models.

Scala is a modern object-oriented, functional programming language that is well-suited for developing simulation engines. It is in the Java family of languages and can call Java code. The inclusion of advanced and functional programming capabilities, makes the code much more concise than Java. ScalaTion also supports optimization and analytics as they nowadays go hand-in-hand with simulation modeling. Some of the algorithms come in both sequential and parallel versions.

The ScalaTion 2.0 version defines multiple .par subpackages that contain parallel versions of sequential algorithms. Future directions include completing the 'scala3d' and 'physics' packages.

Please read the LICENSE file (an MIT style license).

---

Installation Instructions

Version 2.0 Requires: Scala 3.3.0 and Java 17 to Java 20 (or from Open JDK Archive)
Recommended: sbt   (see Setup.html)
Getting started: sbt Hello, World

1. Download one of the following two files

scalation_2.0.tar.gz
OR
scalation_2.0.zip

2. Untar or unzip the file

$ tar xvfz scalation_2.0.tar.gz 
 OR
$ unzip scalation_2.0.zip

3. To build all the modules, change into the ScalaTion base directory and run sbt

$ cd scalation_2.0
$ sbt compile

4. To compile code or run apps, enter sbt and type compile, runMain or exit

$ sbt
> compile
> runMain scalation.modeling.simpleRegressionTest
> runMain scalation.modeling.regressionTest
> exit

The compile command is optional, since runMain will automatically compile if need be.

ScalaTion is set up to use the Simple Build Tool sbt. ScalaTion 2.0 uses the following build specification file:

1. Build Specification: build.sbt,

Source packages are in the src/main/scala directory, class files are in the target/scala-3.3.0/classes directory, and documentation files are in the target/scala-3.3.0/api directory. Unmanaged jar files are stored in a common library lib directory, where_is_jar.txt. Data file input, output or analytics are stored in subdirectories of data, while database files are stored in store.

5. To develop projects that use ScalaTion that are outside ScalaTion do the following

$ cd your_project_dir
$ sbt new sbt/scala-seed.g8
$ cd hello
$ mkdir lib
copy jar files from lib
$ cd src/main/scala/example
$ vim Hello.scala

The second time you do this, you will want to use a more appropriate name than hello.

---

6. Alternatively, you may use my_scalation_2.0

Downloading and (unzip/tar xvfz) either my_scalation_2.0.zip or my_scalation_2.0.tar.gz and then

$ cd my_scalation_2.0
$ ls -l lib
$ sbt
> run

Check to make sure the ScalaTion .jar file is in the lib directory (ls -l lib). The location of ScalaTion's .jar file may be found in where_is_jar.txt. The sbt run command will allow you to choose any main method to run (or you may use runMain).

---

To develop using an Integrated Development Environment (IDE) [IntelliJ]:

1. IntelliJ IDEA
2. Scala Plugin

---

Papers/Documentation

1. John A. Miller, Jun Han and Maria Hybinette, "Using Domain Specific Languages for Modeling and Simulation: ScalaTion as a Case Study," Proceedings of the 2010 ACM/IEEE Winter Simulation Conference (WSC'10), Baltimore, Maryland (December 2010) pp. 741-752.

2. Michael E. Cotterell, John A. Miller, Tom Horton, "Unicode in Domain-Specific Programming Languages for Modeling & Simulation: ScalaTion as a Case Study," Arxiv preprint arXiv:1112.175 (December 2011) pp. 1-10.

3. Michael E. Cotterell, John A. Miller, Jun Han and Tom Horton, "Extending ScalaTion, a Domain-Specific Language for Modeling & Simulation, for Simulation Optimization," Proceedings of the AlaSim International Modeling and Simulation Conference & Exhibition (AlaSim'12), Huntsville, Alabama (May 2012) pp. 1-1.

4. Yung Long Li, "Evaluation of Parallel Implementations of Dense and Sparse Matrices for the ScalaTion Library," Technical Report, University of Georgia (December 2012) pp. 1-60.

5. John A. Miller, Michael E. Cotterell and Stephen J. Buckley, "Supporting a Modeling Continuum in ScalaTion: From Predictive Analytics to Simulation Modeling," Proceedings of the 2013 ACM/IEEE Winter Simulation Conference (WSC'13), Washington, DC (December 2013) pp. 1191-1202.

6. Matthew Saltz, Ayushi Jain, Abhishek Kothari, Arash Fard, John A. Miller, and Lakshmish Ramaswamy, "DualIso: An Algorithm for Subgraph Pattern Matching on Very Large Labeled Graphs," Proceedings of the 3rd IEEE International Congress on Big Data (BigData'14), Anchorage, Alaska (June-July 2014) pp. 498-505.
   Online supplement

---

Source Packages (doc)

Package	Description
scalation	The scalation foundational packages.
animation	The `animation` package supports the animation of models.
calculus	The `calculus` package supports numerical differentiation and integration.
database	The `database` package supports relational and graph databases.
dynamics	The `dynamics` package supports the development of ODE models.
mathstat	The `mathstat` package supports basic math and statistics.
modeling	The `modeling` package supports the development of several type of data science models.
optimization	The `optimization` package supports linear and nonlinear optimization.
random	The `random` package supports random variate generation.
scala2d	The `scala2d` package supports simple 2D graphics in scala, based upon `java.swing`, `java.awt` and `java_awt_geom`.
simulation	The `simulation` package supports the development of simulation models.

Source Packages (src)

Package	Description
scalation	Scalation Foundational Packages.
animation	The `animation` package supports the animation of models.
calculus	The `calculus` package supports numerical differentiation and integration.
database	The `database` package supports relational and graph databases.
dynamics	The `dynamics` package supports development of ODE models.
mathstat	The `mathstat` package supports basic math and statistics.
modeling	The `modeling` package supports the development of several type of data science models.
optimization	The `optimization` package supports linear and nonlinear optimization.
random	The `random` package supports random variate generation.
scala2d	The `scala2d` package supports simple 2D graphics in scala, based upon `java.swing`, `java.awt` and `java_awt_geom`.
simulation	The `simulation` package supports the development of simulation models.