ctmm-initiative / ctmmweb

Web app for analyzing animal tracking data, built upon ctmm R package
http://biology.umd.edu/movement.html
GNU General Public License v3.0
32 stars 21 forks source link

Documentation for model selection #121

Closed jmcalabrese closed 4 years ago

jmcalabrese commented 4 years ago

The OUf and OU Omega models are not listed in the models table in the model selection help entry. Please update the table to include these. I remember that this caused some confusion during the Brazil course last year, but I forgot to post an issue about it then.

Also, the models table in the help doesn't render correctly on my system, with the column titles smashed together.

xhdong-umd commented 4 years ago

That table was added long time ago and not updated. I cannot find where I got that table now. @chfleming Can you give me some reference or text?

The model table have some unicode symbols. I was using UTF-8 which should be correct. This kind of problem is hard to debug as I didn't see problem in my Mac and windows machine... What locale and language you are using?

jmcalabrese commented 4 years ago

@xhdong-umd That table came from the 2016 MEE paper I led ( https://doi.org/10.1111/2041-210X.12559). The OUf and OU Omega models didn't exist then. I believe there is documentation for these new models in ctmm that you could bring over to the webapp and/or @chfleming could provide some.

My locale is US and language is US English.

The issue with the way the table renders is that there is not enough spacing between columns, so that the column titles run together. See attached screenshot.

table

jmcalabrese commented 4 years ago

@xhdong-umd, @chfleming has there been any follow-up on adding the above-mentioned documentation?

xhdong-umd commented 4 years ago

@jmcalabrese @chfleming I'm waiting for the documentation as I don't know about the details. Once they were provided I can update the help text.

chfleming commented 4 years ago

Sorry, both are autocorrelated position and autocorrelated velocity, and home range.

For parameters, OUf is $\tau = {\tau,\tau}$, where effectively $\tau_r=\tau_v$, and OUO is $\tau = {\tau,\tau}$ and $\omega>0$.

xhdong-umd commented 4 years ago

@chfleming What's the full name of OUf and OUO, like the names in the reference table?

Should I also update the reference to include paper related to the new models? I put header in two rows and adjusted spacing

image

chfleming commented 4 years ago

OU in both cases stands for Ornstein-Uhlenbeck, while the 'F', 'f', 'Omega' don't have to mean anything, and can be expressed similarly to the OUF case. Your choices are probably more descriptive.

The omega in the OUO parameterization should be lower case, though.

xhdong-umd commented 4 years ago

Updated to this image