Package: geocollector
GEO CollectorDescriptionGEOcollector is a Python package for collecting metadata about gene expression datasets from the NCBI Gene Expression
Omnibus (GEO) database. It will convert a list of GSM accession numbers and cell types into the information required
forFastqToGeneCountsto process the raw RNA-seq data.Long story short, given an input file like this:GSM,cell_type
GSM3785334,baso
GSM3898581,basoGEOcollector will output a file like this (without formatted columns):GSE       ,GSM        ,SRR        ,Rename    ,Strand ,Prep Method ,Platform Code ,Platform Name                      ,Source           ,Cell Characteristics                                                                                                                                                                                                                        ,Replicate Name                                                        ,Strategy ,Publication ,Extra Notes
GSE131525 ,GSM3785334 ,SRR9097791 ,baso_S1R1 ,SE     ,total       ,GPL16791      ,Illumina HiSeq 2500 (Homo sapiens) ,B                ,subject - disease status: Screened Healthy Control;subject: HC3;age at draw: 55;Sex: Female;median cv coverage: 0.763618;fastq total reads: 6241803;unpaired reads examined: 5663490;unpaired read duplicates: 1597507;primary race: White; ,lib3945                                                               ,RNA-Seq  ,31671072    ,
GSE133028 ,GSM3898581 ,SRR9328889 ,baso_S2R1 ,PE     ,total       ,GPL20301      ,Illumina HiSeq 4000 (Homo sapiens) ,peripheral blood ,cell type: peripheral blood B cells;                                                                                                                                                                                                        ,Patient 2 IgD-CD27- double negative B cells from the peripheral blood ,RNA-Seq  ,32859762    ,
GSE133028 ,GSM3898591 ,SRR9328899 ,baso_S2R2 ,PE     ,total       ,GPL20301      ,Illumina HiSeq 4000 (Homo sapiens) ,peripheral blood ,cell type: peripheral blood B cells;                                                                                                                                                                                                        ,Patient 3 IgD-CD27- double negative B cells from the peripheral blood ,RNA-Seq  ,32859762    ,InstallationTo install GEOcollector, you can use pip:pipinstallGEOcollectorUsageThe following sections are command line parameters associated with GEOcollectorCommand Line InterfaceTo execute GEOcollector, simply call it from the command line with the relevant parametersgeocollector--api-keyAPIKEY--input-file/home/user/input.csv--verbose
geocollector--input-file/home/user/input.csv--quiet
geocollector--api-keyAPIKEY--input-file/home/user/input.csvTo view help for GEOcollector, run the following commandgeocollector--helpAPI KeyWithout an API key, NCBI limits the number of requests to 3 per second. With an API key, this value is increased to 10
requests per second. To obtain an API key, follow the below stepsAccessNCBI's websiteClick "Log In" in the top right cornerIf you do not have an account, create one nowClick your username in the top right cornerClick "Account settings" in the dropdown menuScroll down to the "API Key" sectionClick "Create API Key"Copy the API key that has been createdInput fileThe input file should be a CSV file in the following format. Multiple GSMs can be associated to a single cell typeGSM,cell_type
GSM_1,cell_type_1
GSM_2,cell_type_1
GSM_3,cell_type_1
GSM_4,cell_type_2VerbosityIf you would like to show debug information on the command line, pass the flag--verbose. If you would like to silence
all output (except warnings), pass the flag--quiet. If neither flag is passed, standard "info" messages will be shownIf you have problems, pleasecreate a new issue