AstroImageJ Version 5 - Revision history

John at 21:02, 14 June 2022

2022-06-14T21:02:07Z

← Older revision		Revision as of 21:02, 14 June 2022
Line 19:		Line 19:
	*in fitting light curves		*in fitting light curves
	**iterates bulk removal of outlier data points		**iterates bulk removal of outlier data points
	**features automatic ~~comp~~ ensemble optimization through root mean square (RMS) minimization		**features automatic comparison ensemble optimization through root mean square (RMS) minimization
	**features automatic detrend parameter selection according to the Bayesian information criterion (BIC)		**features automatic detrend parameter selection according to the Bayesian information criterion (BIC)
	*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc		*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc

John at 20:59, 14 June 2022

2022-06-14T20:59:07Z

John at 20:53, 14 June 2022

2022-06-14T20:53:24Z

← Older revision		Revision as of 20:53, 14 June 2022
Line 12:		Line 12:

	*continues to support all previous manual workflow features of AIJ workflow, so you can adopt the new features at your own pace		*continues to support all previous manual workflow features of AIJ workflow, so you can adopt the new features at your own pace
	*directly opens TESScut files, TESS postage stamp sequences, TICA ~~FFIs,~~ and SPOC FFIs from the File menu or by drag and drop onto the AIJ toolbar		*directly opens TESScut files, TESS postage stamp sequences, TICA and SPOC full frame images (FFIs) from the File menu or by drag and drop onto the AIJ toolbar
	*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)		*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)
	*has new automatic aperture size extraction from the images		*in aperture photometry
	*has new automatic ~~comp~~ star selection in aperture photometry		**has new automatic aperture size extraction from the images in aperture photometry
	*iterates bulk removal of outlier data points		**has new automatic comparison star selection in aperture photometry
	*features automatic comp ensemble optimization through RMS minimization		*in fitting light curves
	*features automatic detrend parameter selection according to BIC		**iterates bulk removal of outlier data points
			**features automatic comp ensemble optimization through root mean square (RMS) minimization
			**features automatic detrend parameter selection according to BIC
	*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc		*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc
	*introduces a platform enabling scripted AIJ data reductions if you prefer		*introduces a platform enabling scripted AIJ data reductions if you prefer

John at 20:48, 14 June 2022

2022-06-14T20:48:55Z

← Older revision		Revision as of 20:48, 14 June 2022
Line 33:		Line 33:
	After installation, execute the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and installation the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but may add new features and improve older ones. AIJ V5 is unusual in that it is a such a signficant change in code base that a new installation is necessary.		After installation, execute the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and installation the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but may add new features and improve older ones. AIJ V5 is unusual in that it is a such a signficant change in code base that a new installation is necessary.

	With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block. The optimum number of threads allocated will depend on your computer's CPU architecture. As with memory, use as many CPUs as possible to speed operations. On Linux, the command line "cat /etc/cpuinfo" will report the processor cores that in the machine, and "top" on Linux or Mac will show the current CPU and memory usage by each process. On Windows, try the Ctrl + Shift + Esc keys to open the Task Manager and note the contents of the Performance Tab.		With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block. The optimum number of threads allocated will depend on your computer's CPU architecture. As with memory, use as many CPUs as possible to speed operations. On Linux, the command line "cat /etc/cpuinfo" will report the processor cores that are in the machine, and "top" on Linux or Mac will show the current CPU and memory usage by each process. On Windows, try the Ctrl + Shift + Esc keys to open the Task Manager and note the contents of the Performance Tab.


	[[File:Memory and threads.png\|frameless\|alt=Clock Edit -> Options -> Memory & threads\|AstroImageJ memory and threads selection ]]		[[File:Memory and threads.png\|frameless\|alt=Clock Edit -> Options -> Memory & threads\|AstroImageJ memory and threads selection ]]

John at 05:35, 14 June 2022

2022-06-14T05:35:25Z

← Older revision		Revision as of 05:35, 14 June 2022
Line 1:		Line 1:

	The major new release of AIJ Version 5 on January 5, 2022, requires a fresh installation of the software. Current users of AIJ should ~~following~~ the instructions here or on the AstroImageJ website to take advantage of the improvements it provides to the ~~previous version's features, and the new ones it adds~~. Future upgrades of AIJ will be based on Version 5.0 and prior versions based on 3.0 and 4.0 ~~will be~~ deprecated.		The major new release of AIJ Version 5 on January 5, 2022, requires a fresh installation of the software. Current users of AIJ should follow the instructions here or on the AstroImageJ website to take advantage of the improvements it provides over the earlier versions. Future upgrades of AIJ will be based on Version 5.0 and prior versions based on 3.0 and 4.0 are deprecated.

	== New Features ==		== New Features ==


	For Mac users who have had to deal with complex installation workarounds, AIJ v5 now installs on a Mac with no special workarounds. This is thanks to a significant contribution by Eric Jensen to develop a process to properly sign and authenticate the code and installation package. Under the guidance of Karen Collins, Kevin Eastridge implemented most of the detailed coding changes for this version, and ~~she~~ thanks the Smithsonian Astrophysical Observatory (SAO) and George Mason University (GMU) for supporting Kevin's work.		For Mac users who have had to deal with complex installation workarounds, AIJ v5 now installs on a Mac with no special workarounds. This is thanks to a significant contribution by Eric Jensen to develop a process to properly sign and authenticate the code and installation package. Under the guidance of Karen Collins, Kevin Eastridge implemented most of the detailed coding changes for this version, and Karen thanks the Smithsonian Astrophysical Observatory (SAO) and George Mason University (GMU) for supporting Kevin's work.

	The new version was tested for more than two months before this release, but the updates are massive. ~~There~~ have been updates to it ~~since then~~ which ~~may~~ be applied once the installation is completed. ~~Nevertheless~~, you may keep your current version of AIJ installed by changing its upper level folder name (or on Mac, the app name), and then installing Version 5 as you normally would. Both versions use the same preferences file, so you will be able to switch back and forth if needed.		The new version was tested for more than two months before this release, but the updates are massive. Consequently, there already have been updates to it which should be applied once the installation is completed. While the new release with its updates is stable for production use, you may keep your current version of AIJ installed by changing its upper level folder name (or on Mac, the app name), and then installing Version 5 as you normally would. Both versions use the same preferences file, so you will be able to switch back and forth if needed.

	The ~~major new features~~ are:		The highlights are that AIJ Version 5

	*all previous manual features AIJ workflow ~~continue to be supported~~, so you can adopt the new features at your own pace		*continues to support all previous manual workflow features of AIJ workflow, so you can adopt the new features at your own pace
	*directly opens TESScut files, TESS postage stamp sequences, TICA FFIs, and SPOC FFIs (drag and drop on AIJ toolbar)		*directly opens TESScut files, TESS postage stamp sequences, TICA FFIs, and SPOC FFIs from the File menu or by drag and drop onto the AIJ toolbar
	*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)		*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)
	*automatic aperture size extraction		*has new automatic aperture size extraction from the images
	*automatic comp star selection		*has new automatic comp star selection in aperture photometry
	*bulk removal of outlier data points		*iterates bulk removal of outlier data points
	*automatic comp ensemble optimization through RMS minimization		*features automatic comp ensemble optimization through RMS minimization
	*automatic detrend parameter selection according to BIC		*features automatic detrend parameter selection according to BIC
	*automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc		*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc
	*~~introduction of~~ a platform ~~for~~ scripted AIJ data reductions ~~in the future~~		*introduces a platform enabling scripted AIJ data reductions if you prefer
	*and many other enhancements and improvements		*and has many other enhancements and improvements in its internal operations and submenu options

	== Installation ==		== Installation ==

John at 05:24, 14 June 2022

2022-06-14T05:24:44Z

← Older revision		Revision as of 05:24, 14 June 2022
Line 33:		Line 33:
	After installation, execute the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and installation the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but may add new features and improve older ones. AIJ V5 is unusual in that it is a such a signficant change in code base that a new installation is necessary.		After installation, execute the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and installation the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but may add new features and improve older ones. AIJ V5 is unusual in that it is a such a signficant change in code base that a new installation is necessary.

	With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block.		With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block. The optimum number of threads allocated will depend on your computer's CPU architecture. As with memory, use as many CPUs as possible to speed operations. On Linux, the command line "cat /etc/cpuinfo" will report the processor cores that in the machine, and "top" on Linux or Mac will show the current CPU and memory usage by each process. On Windows, try the Ctrl + Shift + Esc keys to open the Task Manager and note the contents of the Performance Tab.


	[[File:Memory and threads.png\|frameless\|alt=Clock Edit -> Options -> Memory & threads\|AstroImageJ memory and threads selection ]]		[[File:Memory and threads.png\|frameless\|alt=Clock Edit -> Options -> Memory & threads\|AstroImageJ memory and threads selection ]]

John: Created page with " The major new release of AIJ Version 5 on January 5, 2022, requires a fresh installation of the software. Current users of AIJ should following the instructions here or on the AstroImageJ website to take advantage of the improvements it provides to the previous version's features, and the new ones it adds. Future upgrades of AIJ will be based on Version 5.0 and prior versions based on 3.0 and 4.0 will be deprecated. == New Features == For Mac users who have had t..."

2022-06-14T05:11:40Z

Created page with " The major new release of AIJ Version 5 on January 5, 2022, requires a fresh installation of the software. Current users of AIJ should following the instructions here or on the AstroImageJ website to take advantage of the improvements it provides to the previous version's features, and the new ones it adds. Future upgrades of AIJ will be based on Version 5.0 and prior versions based on 3.0 and 4.0 will be deprecated. == New Features == For Mac users who have had t..."

New page

The major new release of AIJ Version 5 on January 5, 2022, requires a fresh installation of the software. Current users of AIJ should following the instructions here or on the AstroImageJ website to take advantage of the improvements it provides to the previous version's features, and the new ones it adds. Future upgrades of AIJ will be based on Version 5.0 and prior versions based on 3.0 and 4.0 will be deprecated.

== New Features ==

For Mac users who have had to deal with complex installation workarounds, AIJ v5 now installs on a Mac with no special workarounds. This is thanks to a significant contribution by Eric Jensen to develop a process to properly sign and authenticate the code and installation package. Under the guidance of Karen Collins, Kevin Eastridge implemented most of the detailed coding changes for this version, and she thanks the Smithsonian Astrophysical Observatory (SAO) and George Mason University (GMU) for supporting Kevin's work.

The new version was tested for more than two months before this release, but the updates are massive. There have been updates to it since then which may be applied once the installation is completed. Nevertheless, you may keep your current version of AIJ installed by changing its upper level folder name (or on Mac, the app name), and then installing Version 5 as you normally would. Both versions use the same preferences file, so you will be able to switch back and forth if needed.

The major new features are:

*all previous manual features AIJ workflow continue to be supported, so you can adopt the new features at your own pace
*directly opens TESScut files, TESS postage stamp sequences, TICA FFIs, and SPOC FFIs (drag and drop on AIJ toolbar)
*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)
*automatic aperture size extraction
*automatic comp star selection
*bulk removal of outlier data points
*automatic comp ensemble optimization through RMS minimization
*automatic detrend parameter selection according to BIC
*automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc
*introduction of a platform for scripted AIJ data reductions in the future
*and many other enhancements and improvements

== Installation ==

The new Windows, Mac, and Linux installation packages are available from the AIJ website [https://www.astro.louisville.edu/software/astroimagej/installation_packages/ here] with instructions for how to use each one. Download the package with the name matching your operating system including "v5" with the most resent version increment, and then follow the appropriate directions

*[https://www.astro.louisville.edu/software/astroimagej/installation_packages/ AstroImageJ_installation_windows.html Windows (any version 7 and above)]
*[https://www.astro.louisville.edu/software/astroimagej/installation_packages/AstroImageJ_installation_mac.html Mac (now simplified)]
*[https://www.astro.louisville.edu/software/astroimagej/installation_packages/AstroImageJ_installation_linux.html Linux (any distribution)]

After installation, execute the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and installation the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but may add new features and improve older ones. AIJ V5 is unusual in that it is a such a signficant change in code base that a new installation is necessary.

With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block.

[[File:Memory and threads.png|frameless|alt=Clock Edit -> Options -> Memory & threads|AstroImageJ memory and threads selection ]]

← Older revision		Revision as of 20:59, 14 June 2022
Line 15:		Line 15:
	*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)		*directly opens zipped fits.fz files as downloaded from the LCOGT archive (no unzipping or FUNPack decompression required, just drag and drop the single zip file on the AIJ toolbar)
	*in aperture photometry		*in aperture photometry
	**has new automatic aperture size extraction from the ~~images in aperture photometry~~		**has new automatic aperture size extraction from the first image
	**has new automatic comparison star selection ~~in aperture photometry~~		**has new automatic comparison star selection based on the target star
	*in fitting light curves		*in fitting light curves
	**iterates bulk removal of outlier data points		**iterates bulk removal of outlier data points
	**features automatic comp ensemble optimization through root mean square (RMS) minimization		**features automatic comp ensemble optimization through root mean square (RMS) minimization
	**features automatic detrend parameter selection according to BIC		**features automatic detrend parameter selection according to the Bayesian information criterion (BIC)
	*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc		*will automatically run the "Add Data" function at the end of the Multi-Aperture run to add new data columns such as BJD_TDB, airmass, etc
	*introduces a platform enabling scripted AIJ data reductions if you prefer		*introduces a platform enabling scripted AIJ data reductions if you prefer
	*and has many other enhancements and improvements in its internal operations and ~~submenu~~ options		*and has many other enhancements and improvements to speed its internal operations and provide menu options

	== Installation ==		== Installation ==
Line 33:		Line 33:
	*[https://www.astro.louisville.edu/software/astroimagej/installation_packages/AstroImageJ_installation_linux.html Linux (any distribution)]		*[https://www.astro.louisville.edu/software/astroimagej/installation_packages/AstroImageJ_installation_linux.html Linux (any distribution)]

	After installation, ~~execute~~ the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and ~~installation~~ the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but ~~may~~ add new features and improve older ones. AIJ V5 is unusual in that it is a such a ~~signficant~~ change in code base that a new installation is necessary.		After installation, start the program and go to the AIJ_Toolbar Help -> Update AstroImageJ and install the most recent updates. AIJ is dynamic, and the updates not only correct newly discovered errors, but add new features and improve older ones. This new version 5 of AIJ is unusual in that it is a such a significant change in code base that a new installation is necessary.

	With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block. The optimum number of threads allocated will depend on your computer's CPU architecture. As with memory, use as many CPUs as possible to speed operations. On Linux, the command line "cat /etc/cpuinfo" will report the processor cores that are in the machine, and "top" on Linux or Mac will show the current CPU and memory usage by each process. On Windows, try the Ctrl + Shift + Esc keys to open the Task Manager and note the contents of the Performance Tab.		With the latest updates installed, Use the Edit -> Options -> "Memory and Threads" menus and update the "Maximum memory" value from the default to your preferred AIJ memory usage limit. Unless you have other memory-intensive processes running multitasking with AIJ, we recommend using about 75% of your computer's physical memory to provide space for long data series. For example, if your computer has 8 GB of memory, set the maximum memory value to 6000 MB. There is no software limit, and for some operations in AIJ it is useful to hold long time series in memory as a block. The optimum number of threads allocated will depend on your computer's CPU architecture. As with memory, use as many CPUs as possible to speed operations. On Linux, the command line "cat /etc/cpuinfo" will report the processor cores that are in the machine, and "top" on Linux or Mac will show the current CPU and memory usage by each process. On Windows, try the Ctrl + Shift + Esc keys to open the Task Manager and note the contents of the Performance Tab.