| Html bobswift | ||||
|---|---|---|---|---|
| ||||
"configure" - WEAVE field-configuration tool
| Table of Contents |
|---|
...
Welcome to the webpage for the "configure" software. Please note that this page is currently intended for use only by open-time PIs.
...
To identify the version you are running, run configure with the --version command line option and the version number will be printed on standard out. For macOS, after moving the app to Applications, run /Applications/configure.app/Contents/MacOS/configure --version.
latest configure version number | date released | linux | mac |
|---|---|---|---|
3.3.2 | 5 April 2022 | configure-3.3.2-Ubuntu-20.04.tar.gz | |
3.3.4 | 21 June 2022 | configure_3.3.4.dmg (macOS ≥11.0) configure_3.3.4-Catalina.dmg (macOS 10.15 - caveat emptor: not yet tested) | |
3.3.5 Corrects the mapping of positioner x/y to the sky (it was rotated by 180 degrees). The mapping has now been verified on sky. | 13 July 2022 | configure-3.3.5-Ubuntu-20.04.tar.gz | configure_3.3.5-Catalina.dmg (macOS 10.15 - updated 02.08.2022) |
3.3.6 | 14 September 2022 | configure-3.3.6-Ubuntu-20.04.tar.gz | This version should run on MacOS 10.15 or later |
3.3.11 Updated test version for workflow testing – this is the release candidate for 3.4 New configure option --enable_fibre_catagory. This version is built with fibre status's matching the current state of the positioner which means that many fibres that are due to be repaired soon are disabled. The --enable_fibre_catagory option allows fibres that are disabled for a specific reason to be enabled. The catagories due for repair are "Bad Ferrule" and "No Magnet". To enable them use: configure --enable "bad ferrule" --enable "no magnet" | 23 February 2023 | configure-3.3.11-CentOS Linux-7.tar.gz configure-3.3.11-Ubuntu-18.04.tar.gz | |
3.4
| 10 March 2023 | configure-3.4-CentOS Linux-7.tar.gz configure-3.4-Ubuntu-18.04.tar.gz | |
3.4.1 Fixes a bug in --enable. Only effects MOS mode; v3.4 configurations are valid but won't have as many allocated fibres as they should. | 21 March 2023 | configure-3.4.1-CentOS Linux-7.tar.gz configure-3.4.1-Ubuntu-18.04.tar.gz | |
3.4.5 The collisions disgnostics are now just produced when the "Check" button is pressed but now includes details of which fibres the positioner would chose to park. List of disabled fibres updated. Use this version for MOS Science Verification | 26 June 2023 | configure-3.4.5-CentOS Linux-7.tar.gz configure-3.4.5-Ubuntu-18.04.tar.gz | |
3.4.6 "configure --max_runtime n" kills the configure command line process after n seconds (with exit status 2). n=0 (the default) disables this feature. This is a workaround for the occasional infinite loop in the sky search phase. List of disabled fibres updated. Notes 4 September:
| 02 August 2023 | configure-3.4.6-CentOS Linux-7.tar.gz configure-3.4.6-Ubuntu-18.04.tar.gz | |
3.4.7 List of disabled fibres updated. | 28 November 2023 | configure-3.4.7-CentOS Linux-7.tar.gz configure-3.4.7-Ubuntu-18.04.tar.gz |
As of version 3.0.0 the input XML must specify the data model version. Old XMLs can be fixed so that configure doesn't complain by adding datamver="8.00" as an attribute of the root element. However, note that old XMLs are not guaranteed to produce the same output, as (1) configure is regularly updated with new information about the fibres and (2) configuration is an intrinsically random process.
...
Documentation
configure documentation | date | more information | downloadable document | ||||
|---|---|---|---|---|---|---|---|
user manual | 31 Mar 2020 |
| |||||
configure XML definition | 29 April 2020 | - document describing format of input field definition - specifies what configure and the positioner software requires (with the exception of quality assessment criteria) |
|
...
Feedback
If you spot any bugs, please contact Scott Trager and Shoko Jin.
...
The program is command line only and has -f and -o command line options for specifying the names of the input and output files.
Here are example input (lifuField.xml) and (lifuConfig.xml) files. (These use the "new" attributes - "targra" instead of "RA_D" etc. etc.)
...