Skip to content

Commit

Permalink
fix: logo in the readme
Browse files Browse the repository at this point in the history
  • Loading branch information
m-kolomanski committed Jan 30, 2025
1 parent 8461b9c commit 2836bdc
Show file tree
Hide file tree
Showing 4 changed files with 34 additions and 22 deletions.
56 changes: 34 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,77 +1,89 @@
# automated Non-Compartmental Analysis (aNCA)
<img src='inst/shiny/www/images/aNCA_logo_bbg.png#gh-dark-mode-only' align="right" alt="aNCA logo dark bg" height="200" style="float:right; height:200px;">
<img src="inst/shiny/www/images/aNCA_logo_wbg.png#gh-light-mode-only" align="right" alt="aNCA logo light bg" height="200" style="float:right; height:200px;">

# automated Non-Compartmental Analysis (aNCA) <img src="man/figures/aNCA_logo_wbg.png" align="right" alt="" width="200" />

<!-- badges: start -->
[<img src="https://pharmaverse.org/shields/aNCA.svg">](https://pharmaverse.org)

[![Pharmaverse](https://pharmaverse.org/shields/aNCA.svg)](https://pharmaverse.org)
[![License](https://img.shields.io/badge/License-Apache_2.0-yellow.svg)](https://opensource.org/licenses/Apache-2.0)
[![CRAN status](https://www.r-pkg.org/badges/version/aNCA)](https://CRAN.R-project.org/package=aNCA)
[![R build status](https://github.com/pharmaverse/aNCA/actions/workflows/main.yml/badge.svg)](https://github.com/pharmaverse/aNCA/actions)
[![RStudio community](https://img.shields.io/badge/community-shiny-blue?style=social&logo=rstudio&logoColor=75AADB)](https://forum.posit.co/new-topic?category=shiny&tags=shiny)
<!-- badges: end -->

<br/>
<!-- badges: end -->

> Our aim is to develop and share an open-source R Shiny application for performing Non-Compartmental Analysis (NCA) on clinical and non-clinical datasets worldwide and across pharmaceutical companies.
<br/>

<br/>
> Our aim is to develop and share an open-source R Shiny application for performing Non-Compartmental Analysis (NCA) on clinical and non-clinical datasets worldwide and across pharmaceutical companies.
<br/>
## Description

This application enables users to upload their datasets and perform Non-Compartment Analysis (NCA) on both pre-clinical and clinical datasets, with the results being easily visualizable. Designed with user-friendliness in mind, this app aims to make NCA accessible and straightforward for all scientists. Among the features it currently possess, the App can:

* **Customize half life calculation**: Either by rule settings definitions or performing manual in-plot adjustments
* **Define AUC intervals of interest**: Providing by default last and to-infinite calculations
* **Visualize data and results** with interactive boxplots, summary statistic tables and scatter plots
* **Produce PP and ADPP** dataset formats of the resulting parameters
* **Save your analysis settings** and reupload them later to keep on analysing!
- **Customize half life calculation**: Either by rule settings definitions or performing manual in-plot adjustments
- **Define AUC intervals of interest**: Providing by default last and to-infinite calculations
- **Visualize data and results** with interactive boxplots, summary statistic tables and scatter plots
- **Produce PP and ADPP** dataset formats of the resulting parameters
- **Save your analysis settings** and reupload them later to keep on analysing!

## Installation

### Via pak (recommended)

We recommend using [pak](https://github.com/r-lib/pak) for package installation, along with all system dependencies. If you do not have `pak` available, you will need to set it up first:

```R
install.packages("pak")
```
then you can install [aNCA](.) by running:

then you can install [aNCA](.) by running:

```R
pak::pak("pharmaverse/aNCA")
```

in your R console.

### Via cloning the repository (for contributors)

Alternatively, you can set up the package by cloning the repository through your terminal/shell:

```bash
git clone https://github.com/pharmaverse/aNCA.git
```

and then loading it directly using [devtools](https://github.com/r-lib/devtools) in your IDE (e.g. RStudio) console:

```R
devtools::load_all()
```

## Quick start

To run the application, simply invoke:

```R
aNCA::run_app()
```

The testing data will be automatically loaded upon application startup. You can provide your own dataset in the **data** tab. Here you can also specify pre-processing filters.

In the **NCA** tab, start off by loading the pre-processed data using *Submit* button. You will also need to choose dose number in the *Settings*. Then, you will be able to run the NCA analysis. From there, you can also specify different analysis options, like applying flag rule sets and selecting slopes.
In the **NCA** tab, start off by loading the pre-processed data using _Submit_ button. You will also need to choose dose number in the _Settings_. Then, you will be able to run the NCA analysis. From there, you can also specify different analysis options, like applying flag rule sets and selecting slopes.

After the setup is done and analysis is performed, you are free to explore the results in the **Outputs** tab. Application supports various customizable plots, as well as report exporting.

For more detailed instructions, you can find a pdf guide [here](docs/aNCA-User-Guide.pdf) in the docs folder.

## Contributing
### As developer
## Contributing

### As developer

To ensure a clean codebase and smooth cooperation, please adhere to the [contributing guidelines](CONTRIBUTING.md).

### As user
### As user

Feel free to open identified [issues](https://github.com/pharmaverse/aNCA/issues/new/choose), to reach out to us for questions or report in our [google sheet](https://forms.gle/c9ULTTv1s75yRaLj7) for feedback.

## Documentation and references

* Please go to [our Website](https://pharmaverse.github.io/aNCA/) for further information on the **aNCA app** (still in development).
* The main package used by the App is `PKNCA`. You can find more of it on its [GitHub](https://github.com/billdenney/pknca)

- Please go to [our Website](https://pharmaverse.github.io/aNCA/) for further information on the **aNCA app** (still in development).
- The main package used by the App is `PKNCA`. You can find more of it on its [GitHub](https://github.com/billdenney/pknca)
Binary file added man/figures/aNCA_logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added man/figures/aNCA_logo_bbg.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added man/figures/aNCA_logo_wbg.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 2836bdc

Please sign in to comment.