Use with N.I.N.A.
N.I.N.A. runs ASTAP as a command-line program and
reads the .ini file it writes. arcsec accepts the same command line and writes the
same file, so N.I.N.A. can use it in ASTAP’s place with no change on N.I.N.A.’s side.
Setting up
Section titled “Setting up”-
Install arcsec. Download the Windows
.zipfrom the latest release, extract it and putarcsec.exein a permanent folder, for exampleC:\Program Files\arcsec\. Getting started has the details. -
Install a star catalogue for your field of view. N.I.N.A. does not tell the solver where the catalogues are, so arcsec uses its own catalogue folder. Use Which catalogue do I need?, or in PowerShell:
Terminal window arcsec catalog recommend --fov 1.2 # your field height in degreesarcsec catalog install d50 # what it recommendedThe install also builds arcsec’s blind index from the catalogue (it shows the size and time first: about 290 MB and half a minute for D50). That is what makes N.I.N.A.’s blind solves fast, below.
If ASTAP is already installed with its databases, you can use those instead and skip the download.
-
Point N.I.N.A. at arcsec. Under Options > Plate Solving, choose ASTAP as the plate solver, and as the blind solver too if you like. Set ASTAP location to the full path of
arcsec.exe, for example:C:\Program Files\arcsec\arcsec.exeType or paste the path into the field. N.I.N.A.’s file browser for this setting only shows files named
astap.exe, so it cannot selectarcsec.exe. Aftercargo install, the path isC:\Users\<you>\.cargo\bin\arcsec.exe. -
Solve. Plate solve from N.I.N.A. as usual. It reports arcsec’s results as it would ASTAP’s.
Reusing ASTAP’s star databases
Section titled “Reusing ASTAP’s star databases”arcsec reads ASTAP’s database files directly, so one copy can serve both programs.
Tell arcsec where they are by setting the ARCSEC_CATALOG_DIR environment variable to
ASTAP’s folder, which is C:\Program Files\astap for a default install:
setx ARCSEC_CATALOG_DIR "C:\Program Files\astap"A program reads its environment when it starts, so restart N.I.N.A. afterwards. Check that arcsec sees the databases with:
arcsec catalog listThen build the blind index once. ASTAP’s folder under Program Files is only writable by an administrator, so run this from a PowerShell opened with Run as administrator (it takes about half a minute and adds one file, about 290 MB, that ASTAP ignores):
arcsec catalog index buildThe solver never modifies these files. The catalogue manager does act on the folder,
though: arcsec catalog remove there would delete ASTAP’s files too. It lists what it
will delete and asks first.
What N.I.N.A. passes
Section titled “What N.I.N.A. passes”N.I.N.A. builds the command line from its own settings, using ASTAP’s options:
| N.I.N.A. setting or value | Option | arcsec’s reading |
|---|---|---|
| The image to solve | -f |
FITS, XISF, ASDF, JPEG, PNG or TIFF, recognised from the contents |
| Field of view, from focal length and pixel size | -fov |
Image height in degrees, as ASTAP defines it |
| Where the telescope is pointing | -ra, -spd |
RA in hours; south pole distance (90 + Dec) in degrees |
| Search radius | -r |
Degrees around that position |
| Downsample factor | -z |
Binning before solving; 0 means automatic |
| Maximum number of stars | -s |
Stars used for matching |
The field of view N.I.N.A. sends comes from the focal length and pixel size in its equipment settings, so if solves fail, check those first.
Blind solves
Section titled “Blind solves”When N.I.N.A. blind-solves (with ASTAP chosen as the blind solver, or when a normal
solve fails and it retries blind), it sends -r 180: search the whole sky. With the
blind index installed, arcsec checks the five fields round the position N.I.N.A. gave,
then asks the index, and answers in a second or two. Without one, it searches the sky
field by field, which can take minutes, and prints a hint saying how to build the
index. arcsec catalog list shows whether one is installed.
When arcsec finishes, N.I.N.A. reads <image>.ini next to the image: PLTSOLVD=T with
the solution on success, PLTSOLVD=F on failure. arcsec writes this file on failure
too, as ASTAP does.
Troubleshooting
Section titled “Troubleshooting”See exactly what N.I.N.A. ran
Section titled “See exactly what N.I.N.A. ran”With N.I.N.A.’s log level set to Debug, its log records the full command line it runs
for each solve. The .ini file arcsec writes also records it, on the CMDLINE= line,
whether the solve succeeded or not. Paste that command into Command Prompt or
PowerShell and add --progress to watch each step:
"C:\Program Files\arcsec\arcsec.exe" -f "C:\...\image.fits" -fov 1.2 -z 0 -r 30 --progress& "C:\Program Files\arcsec\arcsec.exe" -f "C:\...\image.fits" -fov 1.2 -z 0 -r 30 --progressThe exit code tells you why a solve failed: run echo %ERRORLEVEL% (Command Prompt) or
$LASTEXITCODE (PowerShell) straight afterwards and look it up in the exit code table. 2 means too few
stars were detected, 32 that no star database was found.
“No output file found”
Section titled ““No output file found””N.I.N.A. found no .ini file after running the solver. arcsec writes one for every
solve it attempts, failed or not, so this usually means it never got that far:
- The path is wrong. Check ASTAP location points at
arcsec.exeitself, including the.exe, and that the file is there. - The image could not be read (exit code 16). Run the command from the log by hand to see the error.
- It does not start at all. Run
arcsec --versionfrom PowerShell to confirm the program runs on this PC.
N.I.N.A. will not run it with automatic downsampling
Section titled “N.I.N.A. will not run it with automatic downsampling”N.I.N.A. checks the version stamped into the ASTAP executable, and refuses to run one
without a version with its default automatic downsampling. The release .zip always
carries the version stamp. A copy built with cargo install only has it if the
Windows SDK’s resource compiler was available at build time. Use the release build, or
set N.I.N.A.’s downsample factor to a fixed value.
“Star database not found” (exit code 32)
Section titled ““Star database not found” (exit code 32)”arcsec found no star database in its catalogue folder. Run arcsec catalog list to
see which folder it is using and what is installed there. If you set
ARCSEC_CATALOG_DIR, restart N.I.N.A. so it picks up the change.
Blind solves take minutes
Section titled “Blind solves take minutes”There is no blind index in the catalogue folder: run arcsec catalog list, which says
so and shows the command and what it costs (arcsec catalog index build). Catalogues
installed with arcsec 0.4 or earlier, and ASTAP’s folder, do not have one until you
build it.
It fails on images that should solve
Section titled “It fails on images that should solve”- Check the focal length and pixel size in N.I.N.A.’s equipment settings. A wrong field of view is the most common cause of a failed solve.
- Check the catalogue covers your field: see Which catalogue do I need?.
- Very crowded Milky Way fields and frames dominated by one bright object, such as a large nebula or a bright star, are the hardest cases for arcsec.
If a solve still fails, please
open an issue with the command line, the
.ini file and, if you can share it, the image.