Skip to content

AstroImageJ/astroimagej

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AstroImageJ

Merged project of Dr. Karen Collins' AstroImageJ.

Developer Instructions

General Use

Clone the repo locally, then run gradlew packageAij[For<Your-OS-Here>] (leave off what is in square brackets to generate all of them) in the repo's folder. The built zip(s) will appear in your-project-root/build/distributions. To build only ij.jar or astronomy_.jar, run gradlew :ij:build or gradlew :Astronomy_:build, respectively.

To run AIJ, use gradlew aijRun. The generated directory, AIJ-Run, will contain the generated version of AIJ.

Special Options

The tasks copyBuiltJars and runAij are configured through text files in the project root, jarLocation.txt and devLaunchOptions.txt, respectively. Both files are ignored by git and will not be commited to the repo. Spelling and case sensitive.

jarLocation.txt contains the absolute path to an AIJ distribution, so that development builds can be tested on a medium-term basis without using Gradle or and IDE to update it each time. When developing in Intellij Idea, if this file is present, the copyBuiltJars task will be run automatically when the hammer icon is clicked.

devLaunchOptions.txt contains the Java launch arguments, eg. -Xmx5000m -Xms256m, the same as the config file AstroImageJ.cfg does for normal installations of AIJ. If present, these options are used in place of the defaults for runAij.

Use in Intellij Idea:

In Idea, go to File > New > Project From Version Control (If it has not opened to a project, select 'Get from Version Control' on the Welcome window.) Enter https://github.com/keastrid/astroimagej for the URL, and direct the path to where you want the project, then click 'clone'. If you had a project open, it will ask you which window to open AIJ in, choose your preference.

Once open, it may notify you that it doesn't have a JDK - if that is so, click the bar and point AIJ to your JDK, or you can have it install one for you.

On the right-hand side, you will see a button labelled 'Gradle' with a little elephant on top. Clicking it wil open the Gradle sidebar. Navigate to AIJ-Merged > Tasks > build > astroimagej development. Double-click on runAij to build and run the project. To build the project, double-click on any of the packageAij tasks. The built zip(s) will appear in your-project-root/build/distributions. To build only ij.jar or astronomy_.jar, navigate to the build commands under their respective modules (instead of Tasks > ..., it will be ij > ... or Astronomy_ > ...). The built jar will be in your-project-root//build/libs.

Code Signing Policy

Windows

Free code signing provided by SignPath.io, certificate by SignPath Foundation.

Privacy Policy

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.

Credits

Icons

AIJ icon

The AIJ icon is a modified version of this image from ESA/Hubble, Creative Commons Attribution 4.0 International

Credit: NASA, ESA, J. Clarke (Boston University, USA), and Z. Levay (STScI)

The image was modified to remove the planet shadow.

Other icons

Other icons are separately licensed. Please see the license files in the icon folders for more information.

Included libraries

ImageJ

A modified version of ImageJ, which is in the public domain.

Licensed in the public domain.

Licensed under GPL-2.0 with classpath exception.

Licensed under Apache 2.0.

Licensed under Apache 2.0.

Licenced under Apache 2.0.

Licensed under MIT license.

Licensed under Apache 2.0.

Licensed in the public domain.

All Rights Reserved, with permission to use, copy, modify and distribute this software and its documentation for educational, research and non-profit purposes. See the full license here.

For AstroImageJ, additional permission under GNU GPL version 3 section 7 is granted: If you modify this Program (AstroImageJ), or any covered work, by linking or combining it with BiSlider (or a modified version of that library), containing parts covered by the terms of BiSlider's license, the licensors of this Program (AstroImageJ) grant you additional permission to convey the resulting work.

See the GPL FAQ for details on use of GPL incompatible libraries in a GPL work.

Licensed under Apache 2.0.