Getting started with semantic Climate

🌍 A Beginner’s Guide to #semanticClimate

Welcome to the #semanticClimate Internship Program — a hands-on opportunity to contribute to climate knowledge while building valuable technical skills.

This internship allows you to work at the intersection of climate science, data analysis, and semantic technologies, helping transform complex climate reports into structured, accessible knowledge.

---

🚀 Why Join?

Interns are at the core of our work. By contributing to real-world climate data projects, you will:

• Support efforts to make climate knowledge more accessible
• Work with real scientific reports (e.g., IPCC)
• Gain practical experience in tools, data analysis, and research workflows
• Develop transferable skills in NLP, data processing, and web-based systems

---

⏳ Internship Duration

• Duration: 12 weeks to 6 months
• Mode: Online or Offline (flexible)

---

🛠️ The Program

As an intern, you will install, test, and work with semanticClimate toolkits designed for analyzing and structuring climate reports.

These tools help convert unstructured documents into meaningful, machine-readable knowledge.

The tools are the following:

• txt2phrases : Extract key terms and phrases
• encyclopedia : Build structured knowledge resources
• amilib : Process and annotate scientific documents
• pygetpapers : Retrieve research papers
• docanalysis : Analyze and explore document content

Explore more about these tools

📋 Getting Started

Here’s a list of general tasks to begin your internship:

• Set up the development environment
• Install required tools and dependencies
• Run initial tests on sample climate documents
• Explore tool functionalities and outputs
• Document your observations and progress

---

🌱 What You’ll Gain

• Experience working with real climate data
• Skills in text mining, NLP, and knowledge extraction
• Exposure to semantic web and knowledge graph concepts
• Hands-on experience with collaborative and research workflows

🧭 Internship Workflow

🟢 PHASE 0: ONBOARDING

Set up your basic development environment:

• Install python and pip
• Install git and get an ID on GitHub
• install pytest
• be able to use a text editor (Notepad++, TextMate, or many others NOT Word)
• have an IDE (VSCode, PyCharm, etc.). Go for the freely accessible community editions.
• learn the basics of Markdown

🧪 PHASE 1: UNIT TESTING (amilib)

Learn to run tests on a real project.

Cloning amilib repository from github and running pytest from commandline/terminal

1. Open your terminal

2. Create a working directory:

   mkdir myproject
   cd myproject
   
   

3. Clone the repository

   git clone https://github.com/petermr/amilib.git
   
   

4. Navigate into the folder:

   cd amilib
   
   

5. Check available branches:

   git branch -a
   
   

6. Switch to the required branch:

   git checkout [branch-name]
   
   

7. Pull latest updates:

   git pull
   
   

8. Run all the test:

   pytest
   
   

9. Report any issues on the GitHub repository issue section.

🔄 PHASE 2: PROGRESSING

• Apply the same workflow used in Phase 1 to other repositories
• Clone → Setup → Run tests → Analyze results
• Explore different tools and understand their functionalities
• Document errors, observations, and learning outcomes
• Gradually work independently with minimal guidance

🔧 PHASE 3: LEARNING GIT COMMANDS

Essential Git Commands

Command	Description
git clone <url>	Copy a remote repository to your local machine. The repository URL can be an HTTP(s) URL or an SSH URL.
git status	Check current changes and file states
git add <file>	Adds the specified file to the staging area, making it ready to be committed.
git commit -m "message"	Save changes with a message
git push origin <branch>	Uploads local branch commits to the remote repository branch.
git pull origin <branch>	Fetches and integrates changes from the remote repository to your local working directory.
git branch	List or create branches
git checkout <branch>	Switches to the specified branch.
git stash	Temporarily save changes

👉 Learn how to create a new branch

• CLICK HERE to Read the steps

👉 Learn Regular Expressions (Regex):

• CLICK HERE

---

🌍 PHASE 4: CLIMATE REPORT SELECTION

• Click Here to read the structure of IPCC/AR6 reports

• Go to either IPCC official website or see the structure of the IPCC Reports from HERE
• Navigate through the different working groups.
• Watch the presentation video for the overview of IPCC/AR6 report.
• Select a chapter from the IPCC/AR6 report that you find interesting.
• Download and convert it to semantic form using amilib and amiclimate tool.
• Create a dictionary specific to the selected chapter and annotating the chapter with dictionary terms.

How to use graphviz tool to make flowcharts, diagram etc.

• Colab Notebook to learn the tool

Read about the projects done by Interns

• Click Here

Resources for climate knowledge

• Click Here

HIGH-PRIORITY:

• See the resource page of #semanticClimate website.
• Attend daily Zoom meetings.
• Report problems to the specific github repositories as an issue with full description.
• Update daily progress sheet (what I DID, what I WILL do, What's BLOCKING me): CLICK HERE
• Share weekly reports on every Friday.
• Join our Slack workspace that’s where we coordinate with team members and others.
• Update your unavailability for meeting in #coordination channel of Slack.
• Email to semanticclimate@gmail.com for any query.

← Back