{{attachment:interbull loggo webb.png|interbull loggo webb.png}} = GEBVtest Software = The GEBV test is a validation procedure described in the Interbull Code of Practice, Appendix VIII. <> This software consists of a program ('''''gebvtest.py''''') and utility module used by those programs ('''''ibutils.py'''''). '''''gebvtest.py''''' program will perform the GEBV validation tests for all traits for one breed and population and then create a zip file with the input and output files, ready for submission to the Interbull Centre. ---- == Installation and testing == The programs have been tested under Python 3 (minimum 3.6) . As a minimum you will need to have these extra python modules installed on your system: !NumPy. Please note that Python2 is no longer supported by developers. Download the attached '''[[attachment:gebvtest20211001.zip||&do=get]]''' file. Create a working directory and unzip the zip file in that directory. Two subdirectories will be created, ''programs'' and ''sample data''. Typing . `python gebvtest.py --help` from a command line prompt, from within the ''programs'' directory, should print a brief help message if the installation has been successful. Some sample data for breed HOL and population ABC are available in the ''sample_data'' directory. The program can be run from the ''programs'' directory as follows:--( )-- {{{ python gebvtest.py -v -m hol abc ../sample_data }}} In this example data, parameters and output are all in the sample_data directory. Files can be read from other locations and output written to other locations as well. Please see the following sections for further information. The outputs should match those in the source zip file.--( )-- ---- <> ---- == GEBV test data submission == '''Interbull customers willing to participate in the GEBV test must send to the Interbull Centre the following files to interbull@slu.se : ''' * '''''Submission zip file''''' - generated by the gebvtest.py program. * '''''Form GENO''''' - one form for each trait group validated. ---- == Troubleshooting/FAQ == * Double check your data files and make sure the file formats are ok. * In some cases special characters in bull names make the program crash. A hint is to leave out the bull names as they are not used anyway. * All your files should contain a field of “country sending this information” and the code should be consistent for all files. Leaving a blank instead of a code for “country sending this information” has the effect that the file is not read. * The record type (fist three positions of the file) must correspond to the data. So if your file is a longevity file the record type must be ‘017’ and not ‘717’ or ‘019’ or anything else. * Make sure to use the -v flag and check the log files carefully (look for files with 0 records, for example) * If python crashes with an error message: * if any "import" statement causes an error, Python or one of the modules is not correctly installed * If bulls seem to be missing or in excess in the candidate or test groups, use -v -m options, but not -C, and check the link '''[[https://wiki.interbull.org/public/gebvtest_mergefiles?action=print|merged files]]'''. ---- If you need assistance, please do not hesitate to contact us at [[mailto:interbull-hgen@slu.se|interbull@slu.se]] .