# Using the SciBeh Hypothes.is Knowledge Base

## Video guide to SciBeh knowledge base
You can watch the video below for a quick visual guide to using SciBeh's hypothes.is knowledge base. The video covers all the content covered below.

<!--{%vimeo 436845680 %}-->

<div style="padding:56.25% 0 0 0;position:relative;"><iframe src="https://player.vimeo.com/video/436845680?h=2ae89f11d0&amp;badge=0&amp;autopause=0&amp;player_id=0&amp;app_id=58479" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen style="position:absolute;top:0;left:0;width:100%;height:100%;" title="SciBeh&amp;#039;s Hypothes.is Tool"></iframe></div><script src="https://player.vimeo.com/api/player.js"></script>

## About hypothes.is and the SciBeh knowledge base

SciBeh maintains an [eclectic knowledge base](https://hypothes.is/groups/Jk8bYJdN/behsci). Here you can find a wide range of items ranging from tweets, newspaper and blog articles, reports to preprints and peer-reviewed articles, all on the topic of behavioural science and responding to COVID-19. We use the tool hypothes.is to annotate each item in the knowledge base. This means that the curated items are tagged with key words, dates, and links to where the item has been referenced on the Internet.

### How the tool works

SciBeh collects input from different sources: discussions on Twitter, Reddit, links sent to us by contributors. Our team of volunteers annotate all of these links---each volunteer annotates 100s each week!---using hypothes.is. When an item is annotated, it gets added to SciBeh's [hypothes.is collection](https://hypothes.is/groups/Jk8bYJdN/behsci). That's the knowledge base you can search for COVID-19-related research and discussion.

You can read more about the process of curating items for the knowledge [here](https://featuredcontent.psychonomic.org/boosting-covid-19-related-behavioral-science-by-feeding-and-consulting-an-eclectic-knowledge-base/).

### How can I use the knowledge base?

#### Search for items

The knowledge base is searchable using any search term you might have. For example, if you are interested in how COVID-19 has affected public wellbeing, you could put `wellbeing` into the search bar.

Do not erase the `group: BehSci` tag when you do this, because you want to be searching for `wellbeing` within the specific knowledge base.


Tags are another good way to find items related to a topic. These are added to items by our annotators, to keep the items organised. You can scroll down the sidebar on the right to find relevant tags.

#### Find linked discussions

A great function of the hypothes.is tool is that it allows us to curate the item and associated discussions---essentially, the context in which it came up. Because we monitor research discussions, we are able to take the feed the links to our annotation along with its source.

For example, someone tweeted about an article on fighting misinformation, which is also relevant to psychological wellbeing. You will find the article in our knowledge base, and also, when you click `Visit annotations in context`, you will see the link to the Twitter post (and any discussions there), too.


### Other tools

SciBeh does not provide these tools, but they are open source from other creators for use with the hypothes.is tool.

#### Integrate the knowledge base into your own website

Hypothes.is can be integrated into websites using an open source API. You can get it at [this site](http://h.readthedocs.io/en/latest/api-reference/v1/) and download the API. Our knowledge base is publicly available, so you can draw freely on that data.


#### Download the annotations

If you want to downlaod the annotations for an article, [here is a tool to do that](http://jonudell.info/h/facet/).

You will need to copy the link of the annotated article (accessed via the knowledge base) and paste it into the box labelled 'url'. You can then select whether you want to download the annotations as an HTML or .csv file, and hit the save icon to download the file to your computer.