Monitoring and Control System (MaCS) 1.2r1

Last updated: 2011-Jun-15

This is a complete rewrite of JMaCS in Scala, and has the following advantages where programmable devices (PDs) are concerned:

• PD API definition is cleaner and more concise
• PD definition, implementation, deployment and programming is fully type-safe.

Please see,

• 14th EISCAT International Workshop (2009) [paper] [slides]
• Scala Days 2011 [paper] [slides] [video]

and the MaCS API (scaladoc) documentation for further details.

How to get started defining your own PDs

The following instructions are for creating an instant Maven project defining an example PD - a steerable antenna, as featured in the paper referred to above.

It will be assumed that you already have (at least version 5 of) the Java runtime environment (JRE) installed, together with an up-to-date version of Maven. This may be ascertained as follows:

$ mvn -version
Apache Maven 2.2.1 (r801777; 2009-08-06 20:16:01+0100)
Java version: 1.6.0_15
Java home: /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home
Default locale: en_US, platform encoding: MacRoman
OS name: "mac os x" version: "10.6" arch: "i386" Family: "mac"

1. Tell Maven to prompt you for parameter values when creating new projects, by adding the following to your settings:

   <interactiveMode>true</interactiveMode>

2. Add the following entry to your ~/.m2/archetype-catalog.xml:

   <?xml version="1.0" encoding="UTF-8"?>
   <archetype-catalog>
     <archetypes>
       ...
       <archetype>
         <groupId>com.lafros.maven.archetypes</groupId>
         <artifactId>macspd-archetype</artifactId>
         <version>1.2</version>
         <repository>http://lafros.com/m2arts</repository>
         <description>Lafros MaCS PD archetype</description>
       </archetype>
     </archetypes>
   </archetype-catalog>

3. Create a new Maven project using the above catalogue entry, as follows:

   $ mvn archetype:generate -DarchetypeCatalog=local

   Supply the following or appropriate values when prompted:

   Choose archetype:
   1: local -> macspd-archetype (Lafros MaCS PD archetype)
   Choose a number:  (1): 1
   Define value for groupId: : org.myorg.macspd
   Define value for artifactId: : myorg-macspd
   Define value for version:  1.0-SNAPSHOT: :
   Define value for package:  org.myorg.macspd: :

4. Build the .jar files for the project's supplied example PD, simulator, and program, and install them in your local repository:

   $ cd myorg-macspd
   $ mvn install

5. Now make changes to the example, and observe their effects. Use the example PD definition, simulator and program as templates for your own creations.

To stay up to date and share your experiences, please join the Lafros MaCS Google group.

Downloads