# Document types for Papers

#### Alfonso R. Reyes

#### 2018-02-18

When a query is returned by OnePetro inside the web page with the results also comes the `dc_type` or document type for all the papers that returned from that search.

The type of papers are:

- Conference paper
- Journal paper
- General
- Media
- Presentation
- Other

If we want to know what type of papers are available for a particular search we follow these steps:

## Create a query

Our search is for the exact words “well test”. How many papers return from that search?

    library(petro.One)

    my_url <- make_search_url(query = "well test",
                              how = "all")          # exact match

    get_papers_count(my_url)

    ## [1] 12361

## Find the type of papers available

    sdc <- papers_by_type(my_url)
    sdc

    ## # A tibble: 7 x 2
    ##   name               value
    ##   <chr>              <dbl>
    ## 1 Chapter             8.00
    ## 2 Conference paper 9569
    ## 3 General           193
    ## 4 Journal paper    2553
    ## 5 Media               5.00
    ## 6 Other               8.00
    ## 7 Presentation       25.0

We see that the most numerous category is conference papers followed by journal. The total number of papers is about 12361

## Variable type of documents

Depending of the words we are searching, the document types that return from the search may not be the same in all cases. For instance, in this case, we don’t get the type for `Other` or `Chapter`.

    library(petro.One)

    my_url <- make_search_url(query = "smart completion",
                              how = "all")          # exact match

    sdc    <- papers_by_type(my_url)
    sdc

    ## # A tibble: 5 x 2
    ##   name              value
    ##   <chr>             <dbl>
    ## 1 Conference paper 375
    ## 2 General            1.00
    ## 3 Journal paper     40.0
    ## 4 Media              1.00
    ## 5 Presentation       3.00

## Get a list of papers for specific type.

### All types for deepwater

    library(petro.One)

    my_url <- make_search_url(query = "deepwater")

    sdc    <- papers_by_type(my_url)
    sdc

    ## # A tibble: 7 x 2
    ##   name                value
    ##   <chr>               <dbl>
    ## 1 Chapter              3.00
    ## 2 Conference paper 13449
    ## 3 General             44.0
    ## 4 Journal paper     2470
    ## 5 Media               68.0
    ## 6 Other               12.0
    ## 7 Presentation       405

### Chapter papers for deepwater

    my_url <- make_search_url(query = "deepwater",
                              dc_type = "chapter")

    onepetro_page_to_dataframe(my_url)

    ## # A tibble: 3 x 6
    ##   title_data          paper_id  source  type     year author1_data
    ##   <chr>               <chr>     <chr>   <chr>   <int> <chr>
    ## 1 Offshore Operation~ "       ~ "     ~ "     ~  1987 Silcox, William H.,~
    ## 2 Development Plan f~ "       ~ "     ~ "     ~  1987 Poston, Steven W., ~
    ## 3 Properties of Prod~ "       ~ "     ~ "     ~  1987 Collins, A. Gene, U~

### Journal papers for deepwater

    my_url <- make_search_url(query = "deepwater",
                              dc_type = "journal-paper")

    onepetro_page_to_dataframe(my_url)

    ## # A tibble: 10 x 6
    ##    title_data       paper_id     source  type      year author1_data
    ##    <chr>            <chr>        <chr>   <chr>    <int> <chr>
    ##  1 Deepwater Opera~ "          ~ "     ~ "      ~  2013 Eaton, Luke, Cono~
    ##  2 Deepwater Proje~ "          ~ "     ~ "      ~  2016 Iversen, Morten, ~
    ##  3 Deepwater Fans   "          ~ "     ~ "      ~  1987 Richardson, J.G.,~
    ##  4 Deepwater Drill~ "          ~ "     ~ "      ~  1986 Chastain, T., Hug~
    ##  5 Technology Focu~ "          ~ "     ~ "      ~  2017 Iversen, Morten, ~
    ##  6 Comments: Deepw~ "          ~ "     ~ "      ~  2006 Donnelly, John, J~
    ##  7 Evolving Deepwa~ "          ~ "     ~ "      ~  2013 Willis, Todd B., ~
    ##  8 Advancing Deepw~ "          ~ "     ~ "      ~  2016 Carpenter, Chris,~
    ##  9 Deepwater-Riser~ "          ~ "     ~ "      ~  1999 Denney, Dennis, J~
    ## 10 Evaluating Deep~ "          ~ "     ~ "      ~  1995 Abbott, P.A., Ake~

### General papers for deepwater

    my_url <- make_search_url(query = "deepwater",
                              dc_type = "general")

    onepetro_page_to_dataframe(my_url)

    ## # A tibble: 10 x 6
    ##    title_data            paper_id   source   type    year author1_data
    ##    <chr>                 <chr>      <chr>    <chr>  <int> <chr>
    ##  1 Stability Of Deepwat~ "        ~ "      ~ "    ~  1982 Sunde, Rolf M.,~
    ##  2 Risers: A Key Challe~ "        ~ "      ~ "    ~  2005 Cook, Howard, B~
    ##  3 Fluid Selection for ~ "        ~ "      ~ "    ~  2005 Ali, Syed A., C~
    ##  4 The Economics of Dee~ "        ~ "      ~ "    ~  1999 Colligan, John,~
    ##  5 Data Visualization C~ "        ~ "      ~ "    ~  1999 Bowering, Dale,~
    ##  6 Critical Application~ "        ~ "      ~ "    ~  2007 Heathman, James~
    ##  7 Lessons Learned From~ "        ~ "      ~ "    ~  2006 Meize, R.A., An~
    ##  8 The Offshore Industr~ "        ~ "      ~ "    ~  2004 Utt, Michael, U~
    ##  9 Wellbore Stability I~ "        ~ "      ~ "    ~  2008 Reem Freij-Ayou~
    ## 10 Gas Hydrates: Friend~ "        ~ "      ~ "    ~  2005 Tohidi, Bahman,~

### Presentation papers for deepwater

    my_url <- make_search_url(query = "deepwater",
                              dc_type = "presentation")

    onepetro_page_to_dataframe(my_url)

    ## # A tibble: 10 x 6
    ##    title_data           paper_id   source  type     year author1_data
    ##    <chr>                <chr>      <chr>   <chr>   <int> <chr>
    ##  1 Video:             ~ "        ~ "     ~ "     ~  2014 Johnson, Austin,~
    ##  2 Video:             ~ "        ~ "     ~ "     ~  2014 Dekker, Martijn,~
    ##  3 Video:             ~ "        ~ "     ~ "     ~  2014 Reid, David, She~
    ##  4 Video:             ~ "        ~ "     ~ "     ~  2015 Goodwin, Alex, W~
    ##  5 Video:             ~ "        ~ "     ~ "     ~  2015 Gutierrez, Jose ~
    ##  6 Video:             ~ "        ~ "     ~ "     ~  2014 Henry, Bill, She~
    ##  7 Video:             ~ "        ~ "     ~ "     ~  2013 Gueveneux, Herve~
    ##  8 Video:             ~ "        ~ "     ~ "     ~  2013 Sutton, Ian S, S~
    ##  9 Video:             ~ "        ~ "     ~ "     ~  2015 Letton, W., Lett~
    ## 10 Video:             ~ "        ~ "     ~ "     ~  2014 Shen, Joseph, Ch~