Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Refresh README #335

Merged
merged 3 commits into from
Jul 18, 2022
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions DESCRIPTION
Original file line number Diff line number Diff line change
Expand Up @@ -22,8 +22,9 @@ Authors@R:
role = "ctb",
email = "patilindrajeet.science@gmail.com",
comment = c(ORCID = "0000-0003-1995-6531", Twitter = "@patilindrajeets")))
Description: An implementation of the Table, Listing and Figure concepts in R. This library provides
a standardized approach to creating tables and graphs based on conventions over configurations.
Description: An implementation of the Table, Listing and Figure concepts in R.
This library provides a standardized approach to creating tables and graphs
based on conventions over configurations.
License: GPL-2 | file LICENSE
URL: https://github.com/open-systems-pharmacology/tlf-library
BugReports: https://github.com/open-systems-pharmacology/tlf-library/issues
Expand Down
67 changes: 48 additions & 19 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,43 +1,72 @@
# TLF Library

TLF Library implementation in R
<!-- README.md is generated from README.Rmd. Please edit that file -->
IndrajeetPatil marked this conversation as resolved.
Show resolved Hide resolved

# tlf: Table, Listing and Figure for OSP

<!-- badges: start -->

[![AppVeyor build status](https://ci.appveyor.com/api/projects/status/github/Open-Systems-Pharmacology/TLF-Library?branch=develop&svg=true)](https://ci.appveyor.com/project/open-systems-pharmacology-ci/TLF-Library/branch/develop){.pkgdown-devel}
[![codecov](https://codecov.io/gh/Open-Systems-Pharmacology/TLF-Library/branch/develop/graph/badge.svg)](https://codecov.io/gh/Open-Systems-Pharmacology/TLF-Library){.pkgdown-devel}
<a
href="https://ci.appveyor.com/project/open-systems-pharmacology-ci/TLF-Library/branch/develop"
class="pkgdown-devel"><img
src="https://ci.appveyor.com/api/projects/status/github/Open-Systems-Pharmacology/TLF-Library?branch=develop&amp;svg=true"
alt="AppVeyor build status" /></a> <a
href="https://app.codecov.io/gh/Open-Systems-Pharmacology/TLF-Library"
class="pkgdown-devel"><img
src="https://codecov.io/gh/Open-Systems-Pharmacology/TLF-Library/branch/develop/graph/badge.svg"
alt="codecov" /></a>

<!-- badges: end -->

# Development tasks
The `{tlf}` package provides an object-oriented framework to create
tables and figures, which are used by R packages in the Open Systems
Pharmacology ecosystem:

- [`{ospsuite}`](https://www.open-systems-pharmacology.org/OSPSuite-R/)
- [`{ospsuite.reportingengine}`](https://www.open-systems-pharmacology.org/OSPSuite.ReportingEngine/)

## dev_mode
## Installation

`devtools::dev_mode` function switches your version of R into "development mode". This is useful to avoid clobbering the existing versions of CRAN packages that you need for other tasks. Calling dev_mode() again will turn development mode off, and return you to your default library setup.
You can install the development version of `{tlf}` from
[GitHub](https://github.com/) with:

```R
# This will install the package in the folder C:/Rpackages
devtools::dev_mode(path="C:/Rpackages")
``` r
# install.packages("remotes")
remotes::install_github("Open-Systems-Pharmacology/TLF-Library")
```

## Reload the package
`{tlf}` requires following packages to be installed:

```R
devtools::load_all()
```
From CRAN:

- [ggplot2](https://cran.r-project.org/package=ggplot2/index.html)
- [jsonlite](https://cran.r-project.org/package=jsonlite/index.html)
- [patchwork](https://cran.r-project.org/package=patchwork/index.html)
- [R6](https://cran.r-project.org/package=R6/index.html)

Must be downloaded manually:

or `Ctrl + Shift + L`
- [ospsuite.utils](https://github.com/Open-Systems-Pharmacology/OSPSuite.RUtils/releases/download/v1.3.17/ospsuite.utils_1.3.17.zip)

## Add or update script files
## Documentation

`.R` files defined in `tests\dev\` will be removed from the package and can be used to simulate interaction with the package. See [scripts.R](tests/dev/scripts.R)
A detailed account of existing functions and articles on how to use them
can be found on the [dedicated
website](https://www.open-systems-pharmacology.org/TLF-Library/).

## Code of conduct

Everyone interacting in the Open Systems Pharmacology community (codebases, issue trackers, chat rooms, mailing lists etc...) is expected to follow the Open Systems Pharmacology [code of conduct](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CODE_OF_CONDUCT.md).
Everyone interacting in the Open Systems Pharmacology community
(codebases, issue trackers, chat rooms, mailing lists etc.) is expected
to follow the Open Systems Pharmacology [code of
conduct](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CODE_OF_CONDUCT.md).

## Contribution

We encourage contribution to the Open Systems Pharmacology community. Before getting started please read the [contribution guidelines](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CONTRIBUTING.md). If you are contributing code, please be familiar with the [coding standards](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CODING_STANDARDS_R.md).
We encourage contribution to the Open Systems Pharmacology community.
Before getting started please read the [contribution
guidelines](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CONTRIBUTING.md).
If you are contributing code, please be familiar with the [coding
standards](https://github.com/Open-Systems-Pharmacology/Suite/blob/master/CODING_STANDARDS_R.md).

## License

Expand Down