OHDSI Home | Forums | Wiki | Github

Data Sources/Achilles documentation

General
#1

We are in the process of validating our data with Achilles. Most graphs are self-explanatory, but others are a bit harder to understand. For instance the Cumulative Observation on the dashboard (.
Both the Atlas and Achilles Documentation do not document the various graphs.

Is there specific documentation for Achilles available?

#2

I am not aware of any official Atlas | Data sources (formerly AchillesWeb) docs that explain the visualizations in detail.

For now the best way to grasp the meaning of these visualizations may be to infer them from the associated queries called in Achilles::exportToJSON(). Some guidance on the Achilles SQL that generate result data is available in Github/Achilles as you mentioned.

Please note that P R Rijnbeek and European colleagues are working on an adjacent effort that may yield exactly the sort of guidance that seek.

The Atlas developers are working on enhaced in-context guidance (e.g. tool tips) and continuously updating the Atlas docs. I expect based on convos with other developes that we will bump up against this and seek to address it in that context as well.

#3

Thanks for the hint about the exportToJSON R code. It seems indeed that there is quite some documentation in the comments. I think it could be very helpful if these comments were gathered, extended and put on the wiki.

This ‘documentation’ answers my own question on the Cumulative Observation graph: the x-axis shows the length of the observation period (in years). Maybe the x-axis title can be adjusted? It now just tells me it is years.

Thanks again!

1 Like
#4

Excellent: I am glad you found what you needed. Yes, that is code to which I was referring.

  • I agree that it would be helpful. Perhaps you can open a new issue and extract and place the relevant comments from exportToJSON in the issue comment?

  • Changing the x-axis title sounds like a good idea. If you were to create a new issue to that effect that would also be helpful to the community.

Thanks.

1 Like
#5

Thanks, will do that.

#6

@t_abdul_basser Thanks for fixing this in the new Atlas release! The new Data Sources page looks really good.

t