{"id":32111478,"url":"https://github.com/ahmohamed/lipidr","last_synced_at":"2026-02-21T06:13:45.692Z","repository":{"id":44562341,"uuid":"172618028","full_name":"ahmohamed/lipidr","owner":"ahmohamed","description":"Data Mining and Analysis of Lipidomics datasets in R","archived":false,"fork":false,"pushed_at":"2023-06-08T11:53:24.000Z","size":53074,"stargazers_count":31,"open_issues_count":10,"forks_count":13,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-11-21T05:15:35.656Z","etag":null,"topics":["bioconductor","lipidomics","r"],"latest_commit_sha":null,"homepage":"https://www.lipidr.org/","language":"R","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ahmohamed.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-02-26T01:56:41.000Z","updated_at":"2025-09-22T14:24:29.000Z","dependencies_parsed_at":"2023-10-20T16:26:03.164Z","dependency_job_id":null,"html_url":"https://github.com/ahmohamed/lipidr","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/ahmohamed/lipidr","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmohamed%2Flipidr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmohamed%2Flipidr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmohamed%2Flipidr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmohamed%2Flipidr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ahmohamed","download_url":"https://codeload.github.com/ahmohamed/lipidr/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ahmohamed%2Flipidr/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29675038,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T05:54:28.202Z","status":"ssl_error","status_checked_at":"2026-02-21T05:53:42.585Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bioconductor","lipidomics","r"],"created_at":"2025-10-20T14:33:58.737Z","updated_at":"2026-02-21T06:13:45.687Z","avatar_url":"https://github.com/ahmohamed.png","language":"R","funding_links":[],"categories":[],"sub_categories":[],"readme":"# *lipidr*: Data Mining and Analysis of Lipidomics Datasets in R \u003cimg src=\"man/figures/logo.png\" align=\"right\" alt=\"\" width=\"120\" /\u003e\n\n[![R-CMD-check](https://github.com/ahmohamed/lipidr/workflows/BiocCheck/badge.svg)](https://github.com/ahmohamed/lipidr/actions)\n[![Coverage status](https://codecov.io/gh/ahmohamed/lipidr/branch/master/graph/badge.svg)](https://codecov.io/github/ahmohamed/lipidr?branch=master)\n[![BioC status](https://bioconductor.org/shields/years-in-bioc/lipidr.svg)](https://bioconductor.org/packages/lipidr/)\n\n## See full guide at [lipidr.org](https://www.lipidr.org/)\n\n## Overall workflow\n\n\u003cimg src=\"man/figures/workflow.png\" width=\"400\"\u003e\n\n## Input\n### Numerical Matrix\nTo use `lipidr` for your analysis using numerical matrix as input, you need 2 files: \n\n1. Numerical table where lipids are rows and samples are columns. Lipid names should be in the first column, and sample names are in the first row. ([see example here](https://github.com/ahmohamed/lipidr/tree/master/inst/extdata/brca_matrix.csv))\n2. A table with the sample annotation / groups, where the sample names are in first column. Note the sample names must be identical in the two files. ([see example here](https://github.com/ahmohamed/lipidr/tree/master/inst/extdata/brca_clin.csv))\n\n\u003cimg src=\"man/figures/num_matrix.png\" width=\"800\"\u003e\n\n`lipidr` can convert these 2 files to `LipidomicsExperiment` as follows:\n\n```r\nd \u003c- as_lipidomics_experiment(read.csv(\"data_matrix.csv\"))\nd \u003c- add_sample_annotation(d, \"data_clin.csv\")\n```\n\n### Export from Skyline\nHere `lipidr` also requires 2 files:\n\n1. Results exported from Skyline as CSV file (see image below). ([see example here](https://github.com/ahmohamed/lipidr/tree/master/inst/extdata/A1_data.csv))\n2. A table / CSV file with the sample annotation / groups, where the sample names are in first column. Note the sample names must be identical in the two files. ([see example here](https://github.com/ahmohamed/lipidr/tree/master/inst/extdata/clin.csv))\n\n\u003cimg src=\"man/figures/skyline_export.png\" width=\"800\"\u003e\n\nIn `lipidr`:\n```r\nd \u003c- read_skyline(\"Skyline_export.csv\")\nd \u003c- add_sample_annotation(d, \"data_clin.csv\")\n```\n\n## LipidomicsExperiment Object\n`lipidr` represents lipidomics datasets as a LipidomicsExperiment, which extends [SummarizedExperiment](http://bioconductor.org/packages/SummarizedExperiment/), to facilitate integration with other Bioconductor packages. \n\n## Quality control \u0026 plotting\n`lipidr` generates various plots, such as box plots or PCA, for quality control of samples and measured lipids. Lipids can be filtered by their %CV.  Normalization methods with and without internal standards are also supported.\n\n## Univariate Analysis\nUnivariate analysis can be performed using any of the loaded clinical variables, which can be readily visualized as volcano plots. Multi-group comparisons and adjusting for confounding variables is also supported (refer to examples on [www.lipidr.org](https://www.lipidr.org/)). A novel lipid set enrichment analysis is implemented to detect preferential regulation of certain lipid classes, total chain lengths or unsaturation patterns. Plots for visualization of enrichment results are also implemented.\n\n## Multivariate Analysis\n`lipidr` implements PCA, PCoA and OPLS(DA) to reveal patterns in data and discover variables related to an outcome of interest. Top associated lipids as well as scores and loadings plots can be interactively investigated using `lipidr`.\n\n# Install *lipidr*\n## From Bioconductor\nIn R console, type:\n\n```r\nif (!requireNamespace(\"BiocManager\", quietly=TRUE))\n    install.packages(\"BiocManager\")\nBiocManager::install(\"lipidr\")  \n```\n\n## Install development version from GitHub\nIn R console, type:\n\n```r\nlibrary(devtools)   \ninstall_github(\"ahmohamed/lipidr\")\n```\n\n## Using Docker\nYou can use `lipidr` in a containerized form by pulling the image from docker hub.\n\n```\ndocker pull ahmohamed/lipidr\ndocker run -e PASSWORD=bioc -p 8787:8787 ahmohamed/lipidr:latest\n```\n\nIn your browser, navigate to RStudio will be available on your web browser at `http://localhost:8787`. The USER is fixed to always being `rstudio`. The password in the above command is given as `bioc` but it can be set to anything. For more information on how-to-use, refer to [Bioconductor help page](https://www.bioconductor.org/help/docker/).\n\nYou can access your local files by mapping to the container:\n\n```\ndocker run -e PASSWORD=bioc -p 8787:8787 \\\n  -v \"path/to/data_folder\":\"/home/rstudio/data_folder\" \\\n  ahmohamed/lipidr:latest\n```\n\nYou should see `data_folder` in your working directory.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmohamed%2Flipidr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fahmohamed%2Flipidr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fahmohamed%2Flipidr/lists"}