AGS Validator (Beta)
The latest version is a Beta version v0.1.1. The Beta version must NOT be used, or specified for use in production scenarios.
For years the industry has had two AGS checker applications that produce different results that have caused clients to specify that AGS files must pass multiple checkers before submitting data to them.
The AGS has been working with a team started by an individual from Fugro, Asitha Senanayake, to solve this problem for the industry. Asitha was working on an open-source library to validate AGS 4.1 files. He linked up with Roger Chandler from Bentley and Tony Daly from Amageo Limited and the result is a development library that has been reviewed, tested and ported over to an AGS GitLab open-source repository.
The library provides validation against the AGS 4.0.3, 4.0.4 and 4.1 formats and can be used within open-source or commercial software, via the command line. The libraries and Desktop App can be downloaded and used free of charge.
The term “validator” has been used rather than “checker”, to clarify that the code only validates against the AGS data format, it does not “check” the accuracy of the data contained in the file.
Please note, the desktop application will not replace all the functionality of the current AGS checkers, in particular, it will not include the ability to edit or amend AGS files. This is considered to be out of scope and should be done using appropriate software and workflows. It also does not support AGS 3.1 format files.
Please either use the form below to submit questions, bugs, wish list items etc.
Installation and running
This build of the software has been tested on Windows 10 only. It is a desktop-only application.
No installation is required for the beta version. The zip file should be extracted to a suitable folder on the system and the .exe file double-clicked. Python runtime libraries are included in the installation folder, Python does not need to be installed on the client PC. A readme.md file is included in the zip folder, this should be opened in a text editor, e.g. Notepad.
Known issues (applies to Beta version 0.1.1)
- The validator does not automatically check the version of the file format. This will be addressed, in the meantime please use the appropriate selector button (the default is 4.0.4). The version is shown in the TRAN group.
- A warning may appear when the application is run for the first time. Please check with your IT section before proceeding.
- The validator should not be extracted to a shared drive e.g. Onedrive.
Contributing to the validator
The AGS validator is an open source project. Developers from 5 countries have contributed their time and knowledge for free to this project and you can join them if you want to geek out with AGS data.
Here are the details you need.
pip installer: https://pypi.org/project/python-ags4/
Conda Installer: https://anaconda.org/conda-forge/python-ags4
Coders Wiki page: https://gitlab.com/ags-data-format-wg/ags-python-library/-/wikis/home
The BGS are developing an on-line application. Links will be added as they become available.