Search specific data version of OncoKB

[asmmhossain]

Hi, I am using oncokb-annotator to annotate somatic mutations from a large cohort of patient samples. I am aware that OncoKB database is regularly updated. I was wondering if there is a way of running oncokb-annotator to search and annotate against a specific version of the database? That could be very helpful to be consistent especially when a project runs for many months. Thanks

[calvinlu3]

Hi @asmmhossain, thanks reaching out! Currently, we don't have a way for users to annotate using a specific data version since the OncoKB API always uses the most recent data version. We are currently making a plan to support this, but I don't have a definitive timeline for when this will be available. I will keep you posted if we made any progress on this.

I will also let @zhx828 chime if he has anything to add.

[juliawiggeshoff]

Just chiming in to support @asmmhossain's request. It would be great to be able to report exactly which data version was used in the process of annotation :)

@calvinlu3 and @zhx828: As it might not be an option for now to select a version for the data release, can the output file (e.g. from MafAnnotator.py) include said information as a column? e.g. ONCOKB_DATA_VERSION

[calvinlu3]

@juliawiggeshoff The original request is still on our board. As for the oncokb data version, you can generate a README using GenerateReadMe.py, which will return the following:

Files annotated on 04/10/2024
OncoKB API URL: https://www.oncokb.org/api/v1
OncoKB data version: v4.15, released on 03/21/2024

[juliawiggeshoff]

Great! Thanks a lot. I should have read the documentation better ;)