Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Retrieving HGNC gene symbol reports (human genes only) via a list of gene IDs. (mac or linux compatible only).


./ -type=ncbi -file=ids.txt -column=hgnc_id -column=symbol

  -help            Brief help message.
  -man             Full documentation.
  -type            Gene ID type within the file.
  -file            File name containing the list of gene IDs.
  -column          This argument can be used multiple times. Will
                   retrieve the columns specified from the gene report.


A perl script which will return tab separated tabular data containing HGNC gene information for each gene ID specified in the user provided file. The script utilises the HGNC REST service and allows the user to retrieve any data that is displayed within our gene symbol reports.



Print a brief help message and exits.


Prints the manual page and exits.


The type of gene IDs found within the provided file. Type can be one of the following:

ncbi               for NCBI gene IDs eg. 673
hgnc               for HGNC gene IDs eg. HGNC:1097
ensembl            for ensembl gene IDs eg. ENSG00000157764
symbol             for HGNC approved symbol eg. TP53


The path of the txt file that contains a list of gene IDs of the type seen above


Use this flag for each column you want to appear within the output. Columns will be tab separated. For a list of columns that you can use please refer to either our REST help page or using the info REST service command and use any columns under "storedFields".


This will only work for macs and linux machines. Git must be installed.

Mac users

If you haven't install git or xcode and you initiate a git clone, your mac may ask you to install xcode. Please install this app and try to git clone once again.


To install this command line tool, clone this project into your directory of choice:

git clone

Once cloned you then need to run the install script:


The install script will download all the required modules needed for the script and will test the script. Once successfully install you may use the script as described above.

Install video

Install video


Retrieving HGNC gene symbol reports (human genes only) via a list of gene IDs.



No releases published


No packages published