2020-02-16 22:45:39 +00:00
# [:cow:]: beefblup
2018-09-10 23:05:30 +00:00
2020-10-12 02:48:19 +00:00
[](https://github.com/MillironX/beefblup/blob/master/LICENSE.md)
[](https://gitter.im/beefblup/community?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)
[](https://GitHub.com/MillironX/beefblup/releases)
2020-02-16 23:46:32 +00:00
beefblup is a program for ranchers to calculate expected breeding
values (EBVs) for their own beef cattle. It is intended to be usable by anyone
without requiring any prior knowledge of computer programming or linear algebra.
Why? It's part of my effort to
2020-02-16 22:45:39 +00:00
**\#KeepEPDsReal**
2019-09-28 07:20:02 +00:00
2020-10-12 02:48:19 +00:00
## Installation
2020-02-16 22:45:39 +00:00
2020-10-12 02:48:19 +00:00
1. [Download and install Julia ](https://julialang.org/downloads/platform/ )
2. Open a new Julia window and type the `]` key
3. Type `add XLSX Gtk` and press **Enter**
2020-02-16 22:45:39 +00:00
2020-10-12 02:48:19 +00:00
Alternatively, you can run the [install
script](https://github.com/MillironX/beefblup/raw/master/Julia/install.jl) from
Julia.
2018-09-10 23:05:30 +00:00
2020-10-12 02:48:19 +00:00
## How to Use
2020-02-16 23:46:32 +00:00
2020-02-20 01:02:52 +00:00
> **Note:** beefblup and [Juno](https://junolab.org)/[Julia Pro](https://juliacomputing.com/products/juliapro.html) currently [don't get along](https://github.com/JunoLab/Juno.jl/issues/118).
2020-02-16 23:46:32 +00:00
> Although it's tempting to just open up beefblup in Juno and press the big play
> button, it won't work. Follow these instructions until it's fixed. If you
> don't know what Juno is: ignore this message.
2020-10-12 02:48:19 +00:00
1. Download the [beefblup ZIP
2020-10-12 02:53:34 +00:00
file](https://github.com/MillironX/beefblup/archive/v0.1.zip) and unzip it
2020-10-12 02:48:19 +00:00
someplace memorable
2. Make a copy of the "Master BLUP Worksheet" and replace the sample data with your own
2020-02-16 23:46:32 +00:00
3. If you wish to add more contemporary group traits to your analysis, replace
or add them to the right of the Purple section
2020-10-12 02:48:19 +00:00
4. Save and close
5. In your file explorer, copy the address of the "Julia" folder
6. Launch Julia
7. Type `cd("<the address copied in step 5")` and press **Enter** (For example,
`cd("C:\Users\MillironX\Documents\beefblup\Julia")` )
8. Type `include("beefblup.jl")` and press **Enter**
9. Select the spreadsheet you created in steps 1-4
2020-02-16 23:46:32 +00:00
10. Follow the on-screen prompts
2020-10-12 02:48:19 +00:00
11. ** #KeepEPDsReal !**
2018-09-10 23:05:30 +00:00
2020-02-16 22:45:39 +00:00
## For Programmers
2020-02-20 01:02:52 +00:00
> **Also Note:** beefblup was written on, and has only been tested with Julia
> v1.2.0 and higher. While this shouldn't affect most everyday users, it might
> affect you if you are stuck on the current LTS version of Julia (v1.0.5).
2020-02-16 22:45:39 +00:00
### Development Roadmap
2018-09-10 23:05:30 +00:00
2020-02-16 22:45:39 +00:00
| Version | Feature |
| ------- | ------------------------------------------------------------------- |
| v0.1 | Julia port of original MATLAB script |
| v0.2 | Spreadsheet format redesign |
2020-10-12 02:48:19 +00:00
| v0.3 | API rewrite (change to function calls and package format instead of script running) |
2020-02-16 22:45:39 +00:00
| v0.4 | Add GUI for all options |
| v0.5 | Automatically calculated Age-Of-Dam, Year, and Season fixed-effects |
| v0.6 | Repeated measurement BLUP (aka dairyblup) |
| v0.7 | Multiple trait BLUP |
| v0.8 | Maternal effects BLUP |
| v0.9 | Genomic BLUP |
| v0.10 | beefblup binaries |
2020-02-16 23:46:32 +00:00
| v1.0 | [Finally, RELEASE!!! ](https://youtu.be/1CBjxGdgC1w?t=282 ) |
2020-02-16 22:45:39 +00:00
2020-02-16 23:46:32 +00:00
### Bug Reports
2019-09-28 07:20:02 +00:00
2020-02-16 23:46:32 +00:00
For every bug report, please include at least the following:
2019-09-28 07:20:02 +00:00
2020-02-16 23:46:32 +00:00
- Platform (Windows, Mac, Fedora, etc)
- Julia version
- beefblup version
- How you are running Julia (From PowerShell, via the REPL, etc.)
- A beefblup spreadsheet that can be used to recreate the issue
- Description of the problem
- Expected behavior
- A screenshot and/or REPL printout
2019-09-28 07:20:02 +00:00
2018-09-10 23:05:30 +00:00
## License
2019-08-03 02:27:05 +00:00
Distributed under the 3-Clause BSD License
