Skip to content

Commit

Permalink
Update UserManual.md
Browse files Browse the repository at this point in the history
  • Loading branch information
tianshu129 authored Mar 20, 2021
1 parent b842f66 commit 78f9e89
Showing 1 changed file with 3 additions and 71 deletions.
74 changes: 3 additions & 71 deletions UserManual.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# FOQAT <img src="https://s1.ax1x.com/2020/08/31/dLqtdf.png" align="right" width="120" />

![Language](https://img.shields.io/badge/Language-R-blue.svg) [![GPLv3 license](https://img.shields.io/badge/License-GPLv3-success.svg)](http://perso.crans.org/besson/LICENSE.html)
![Version](https://img.shields.io/badge/Version-1.5.18-important)
![Version](https://img.shields.io/badge/Version-1.6.2-important)

## Tableof Contents
* [GENERAL OVERVIEW](#general-overview)
Expand Down Expand Up @@ -36,12 +36,8 @@ Features currently included:

* [Calculate Ozone Formation Potential (ofp)](#calculate-ozone-formation-potential-ofp)

* [Get OH Reactivity (koh)](#oh-reactivity-koh)

* [Calculate OH reactivity (loh)](#calculate-oh-reactivity-loh)

* [Format the historical data from OpenAQ (openaq)](#format-the-historical-data-from-openaq-openaq)

* [Calculate TUV in batch (tuv)](#calculate-tuv-in-batch-tuv)

The package contains 4 random sample data sets (5 days in length) to demonstrate functions:
Expand Down Expand Up @@ -397,7 +393,8 @@ ofp(df, unit = "ppbv", t = 25, p = 101.325, stcd=FALSE, sortd =TRUE, colid = 1,
| Variable name | Definition | Default | Example values/remarks |
| ------------------| ----------------------------------|----------------------------|--------------------------------------|
| `df` | dataframe of time series | | |
| `unit` | unit for VOC data (micrograms per cubic meter or ppbv).Please fill in "ugm" or "ppbv" in quotation marks.| "ppbv" | |
| `inunit` | unit for input VOC data (micrograms per cubic meter or ppbv).Please fill in "ugm" or "ppbv" in quotation marks.| "ppbv" | |
| `outunit` | unit for output OFP value (micrograms per cubic meter or ppbv).Please fill in "ugm" or "ppbv" in quotation marks.| "ppbv" | |
| `t` | Temperature, in Degrees Celsius, used to convert data in micrograms per cubic meter to standard conditions (25 Degrees Celsius, 101.325 kPa).| 25| |
| `p` |Pressure, in kPa, used to convert data in micrograms per cubic meter to standard conditions (25 Degrees Celsius, 101.325 kPa).| 101.325| |
| `stcd` | Does it output results in standard conditions? |FALSE | |
Expand All @@ -422,33 +419,6 @@ View(x[["OFP_Result"]])
```


### Get OH Reactivity (koh)
----------
* #### Description

Theoretical values of the species' OH reaction constant kOH at 25 degrees were obtained from' Chemspider.com '. Value source: US Environmental Protection Agency’s EPISuite.

* #### Usage
``` r
koh(spec)
```
* #### Arguments

| Variable name | Definition | Default | Example values/remarks |
| ------------------| ----------------------------------|----------------------------|--------------------------------------|
| `spec` | species | |The name of the species or CAS number are both acceptable.|

* #### Output

Output is the theoretical value of the species' OH reaction constant kOH at 25 degrees.

* #### Examples

``` r
koh("propane")
```


### Calculate OH reactivity (loh)
----------
* #### Description
Expand Down Expand Up @@ -496,44 +466,6 @@ View(x[["LOH_Result"]])
```


### Format the historical data from OpenAQ (openaq)
----------
* #### Description

Format the historical data from openaq.org retrieved by AWS Athena.
How to download data? Please read https://medium.com/@openaq/how-in-the-world-do-you-access-air-quality-data-older-than-90-days-on-the-openaq-platform-8562df519ecd.

* #### Usage
``` r
openaq(df)
```
* #### Arguments

| Variable name | Definition | Default | Example values/remarks |
| ------------------| ----------------------------------|----------------------------|--------------------------------------|
| `df` | dataframe of historical data from openaq.org with certain format| |Need to have 5 species: "o3", "no2", "co", "pm25", "pm10".|

* #### Output

A list which contain a dataframe of formated OpenAQ data and a dataframe for time series of OpenAQ data.

* #### Examples

``` r
#read data into R by using 'read_xlsx' function in 'readxl' pacakage
library(readxl)
#please use your path
path_for_file="xx.xlsx", col_types=c(rep("text",3), "numeric", rep("text",9))
aqidata<- read_xlsx(path_for_file,col_types = col_types)
#process data by using 'openaq' function in 'foqat' pacakage
x=openaq(aqidata)
#view results
View(x)
View(x[["aqidata"]])
View(x[["aqits"]])
```


### Calculate TUV in batch (tuv)
----------
* #### Description
Expand Down

0 comments on commit 78f9e89

Please sign in to comment.