melix / astro4j

Astronomy libraries for Java

Astro4j

A collection of libraries and applications for astronomy image processing in Java.

The project currently only consists of:

• jserfile : a library to read SER video files (for developers)
• math : a library with maths utilities like linear and ellipse regression, image convolution, etc. (for developers)
• ser-player : an application which plays SER files
• JSol'Ex : an application to process Sol'Ex video files
• JSol'Ex CLI : a command-line application to process Sol'Ex video files. This version has to be built from sources, I do not provide installers yet.

If you want some context about why I started developing this, you can read my announcement blog post.

Download links

The following binaries are provided as a convenience and built from sources using GitHub Actions. They are provided as-is, without any warranty.

• Latest release is version 2.1.1 (documentation)
  • JSol'Ex 2.1.1 (Linux, deb, AMD64)
  • JSol'Ex 2.1.1 (Windows)
  • JSol'Ex 2.1.1 (MacOS)
  • JSol'Ex (Tarball)
  • JSol'Ex (Zip)
  • Ser Player 2.1.1 (Linux, deb, AMD64)
  • Ser Player 2.1.1 (Windows)
  • Ser Player 2.1.1 (MacOS)
  • Ser Player (Tarball)
  • Ser Player (Zip)

You can also install the development version of JSol'Ex as it can contain numerous bugfixes and improvements over the release versions.

• Development versions (updated on each commit)
  • JSol'Ex (Linux, deb, AMD64)
  • JSol'Ex (Windows)
  • JSol'Ex (MacOS)
  • JSol'Ex (Tarball)
  • JSol'Ex (Zip)
  • Ser Player (Linux, deb, AMD64)
  • Ser Player (Windows)
  • Ser Player (MacOS)
  • Ser Player (Tarball)
  • Ser Player (Zip)

Licensed under Apache License version 2.

Building from sources

You need to have a Java 21 SDK to build from sources. I recommend that you install GraalVM for Java 21.

This project makes use of Gradle to build. Here are some common tasks you may want to execute:

Description	Task	Example
Run the application	run	./gradlew :jsolex:run
Build without running tests	assemble	`./gradlew :ser-player:assemble
Package as a Zip file	jlinkZipArchive	./gradlew :jsolex:jlinkZipArchive the look into the jsolex/build/installers directory
Execute tests	test	./gradlew :ser-player:test
Build all distributionss	allDistributions	./gradlew allDistributions then look into the build/installers directories

Tasks can be executed on all projects by running ./gradlew <task> or on a single subproject by running ./gradlew :subproject:<task>.

The most common projects you'll want to run on are jsolex (the JSol'Ex application) or ser-player (the SER Player application). For example : ./gradlew :jsolex:run.