The ADAMS source code is hosted in the following subversion repository:
You can check out the code ("trunk") in the console with the following command:
The subversion repository allows public or anonymous read access. When performing a checkout, subversion will usually use your user name to perform the checkout and ask for a password for this user (in the example below, this is fracpete). Simply hit Enter and when prompted for user name, use anonymous with an empty password.
mymachine:~/tmp>svn checkout https://svn.cms.waikato.ac.nz/svn/adams/base/trunk adams Authentication realm: <https://svn.cms.waikato.ac.nz:443> Subversion repository Password for 'fracpete': Authentication realm: <https://svn.cms.waikato.ac.nz:443> Subversion repository Username: anonymous Password for 'anonymous': A adams/adams-twitter A adams/adams-twitter/LICENSE.txt A adams/adams-twitter/src A adams/adams-twitter/src/test ...
Further modules are available:
addons (less common used):
spectral-base (spectral data processing):
applications (domain-specific applications):
libraries (module-specific additional libraries):
ADAMS uses Maven as build tool. See the Requirements section for more details on what you need for compiling the code.
You need to set the environment variable JAVA_TOOL_OPTIONS to -Djsse.enableSNIExtension=false to avoid the Server SSL Error - handshake alert: unrecognized_name error message.
Also recommended, is adding the following parameter to the JAVA_TOOL_OPTIONS in order to always get a full strack traces whenever an error occurs: -XX:-OmitStackTraceInFastThrow
You can compile the source code in the console as follows:
If you want to skip the tests, use the following:
This will generate a ZIP archive in the target directory of the adams-base-all module that contains all the jars and scripts to start ADAMS and the generated documentation.
If your LaTeX binaries (e.g., pdflatex) aren't on the system's path, you need to modify the latex.binariesPath property of the latex profile in the settings.xml file. For instance, if your LaTeX binaries are located in:
Then adapt the latex.binariesPath as follows:
If you are behind a proxy, you need to tell Maven about it. Let's assume that your proxy is called proxy.blah.com and its port 3128.
If you don't need a password to connect to it, you can add the following tag to your settings.xml file:
<proxy> <active>true</active> <protocol>http</protocol> <host>proxy.blah.com</host> <port>3128</port> <nonProxyHosts>localhost|*.blah.com</nonProxyHosts> </proxy>
If your proxy requires a user/password, then you have to 1) generate a master password with Maven (which gets stored in your home directory's .m2/settings-security.xml file) and then 2) the actual password for the proxy. The details are explained here on the Maven homepage. Once you've created the passwords, you have to add the following tag to your settings.xml file and replace the USER and ENCRYPTED_PASSWORD placeholders accordingly.