Skip to content

Latest commit

 

History

History
216 lines (181 loc) · 13.9 KB

README.md

File metadata and controls

216 lines (181 loc) · 13.9 KB
Raw

rada4you

Портал "rada4you" розроблений Громадянською мережею ОПОРА та партнерами. Дізнайся, як нардепи голосували у Раді за проекти рішень, які важливі для тебе. Це може тебе здивувати. Поділися з іншими, поширюй правду.

Огляд

Це бібліотека для роботи з API порталу "Вони голосують для тебе". Вона має 10 базових функцій. Що вони роблять?

  • mps("key") - видає датафрейм із базовою інформацією про кожного народного депутата.
  • mps_info(mp_id, "key") – видає датафрейм із деталізованою інформацією про кожного народного депутата.
  • policies("key") – видає датафрейм із базовою інформацію про усі політики.
  • policy_info(policy_id, "key") – видає датафрейм із голосуваннями, що включені до певної політики.
  • mps_policies(mp_id, "key") – видає датафрейм із рівнем підтримки певного депутата кожної з політик.
  • policy_mps(policy_id, "key") – видає датафрейм із рівнем підтримки політики кожним з нардепів.
  • votings("start_date", "end_date", "key") – видає датафрейм з усіма голосуваннями за обраний період.
  • voting_policies(vote_id, "key") – видає датафрейм із сукупністю політик до яких підв'язане голосування.
  • voting_mps(vote_id, "key") – видає датафрейм із голосуванням кожного нардепа щодо певного голосування.

УВАГА

Для роботи із бібліотекою тобі потрібен key – унікальний API ключ для роботи з порталом RADA4YOU. Отримати ключ можна тут.

Встановлення

# install.packages("devtools")
devtools::install_github("savchukidze/rada4you")

Функції

  • Усі депутати в парламенті

mps("key") - видає датафрейм із базовою інформацією про кожного народного депутата, який наразі є 
членом парламенту. 

* key - персональний ключ API.
Параметр Опис
mp_id Унікальний визначник для кожного депутата
mp_name Ім'я та прізвище нардепа
party Фракційність парламентаря
electorate Спосіб обрання депутата: список/назва області

  • Деталі щодо депутатів

mps_info(mp_id, "key") – видає датафрейм із деталізованою інформацією про кожного народного депутата.

* id - вектор, який містить щонайменше один id парламентаря.
Параметр Опис
mp_id Унікальний визначник для кожного депутата
mp_name Ім'я та прізвище нардепа
party Фракційність парламентаря
electorate Спосіб обрання депутата: список/назва області
rebellions Кількість голосувань проти лінії фракції
votes_attended Загальна кількість голосувань
votes_possible Кількість можливих голосувань, де нардеп міг голосувати

  • Усі політики

policies("key") – видає датафрейм із базовою інформацію про усі політики.
Параметр Опис
policy_id Унікальний визначник для політики
policy_name Коротка назва політики
description Більше деталей про цю політику
provisional TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням)

  • Деталі щодо політики

policy_info(policy_id, "key") – видає датафрейм із переліком голосувань, що включені до певної політики.

* policy_id – вектор, який містить щонайменше один id політики.
Параметр Опис
policy_id Унікальний визначник для політики
policy_name Коротка назва політики
description Більше деталей про цю політику
provisional TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням)
vote__id Унікальний визначник для голосування
vote_name Скорочена назва голосування
date Дата в форматі yyyy-mm-dd
time Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний
aye_votes Кількість депутатів, які проголосували “ЗА”
no_votes Кількість депутатів, які проголосували “ПРОТИ”
rebellions Загальна кількість голосів, які проти лінії фракції

  • Рівень підтримки певного депутата кожної з політик

mps_policies(mp_id, "key") – видає датафрейм із рівнем підтримки певного депутата кожної з політик.
Параметр Опис
mp_id Унікальний визначник для кожного депутата
mp_name Ім'я та прізвище нардепа
party Фракційність парламентаря
electorate Спосіб обрання депутата: список/назва області
policy_id Унікальний визначник для політики
policy_name Коротка назва політики
description Більше деталей про цю політику
provisional TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням)
agreement Рівень підтримки політики нардепом у проміжку від 0 до 100
voted TRUE або FALSE. Показує, чи нардеп колись голосував за законопроект з цієї політики

  • Рівень підтримки певної політики кожним з нардепів`

policy_mps(policy_id, "key") – видає датафрейм із рівнем підтримки політики кожним з нардепів.
Параметр Опис
policy_id Унікальний визначник для політики
policy_name Коротка назва політики
description Більше деталей про цю політику
provisional TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням)
mp_id Унікальний визначник для кожного депутата
mp_name Ім'я та прізвище нардепа
party Фракційність парламентаря
electorate Спосіб обрання депутата: список/назва області
agreement Рівень підтримки політики нардепом у проміжку від 0 до 100
voted TRUE або FALSE. Показує, чи нардеп колись голосував за законопроект з цієї політики

  • Усі голосування за обраний період

votings("start_date", "end_date", "key") – видає датафрейм з усіма голосуваннями за обраний період.

* start_date – перший день обраного періоду
* end_date – останній день обраного періоду

! end_date ≥ start_date
Параметр Опис
vote_id Унікальний визначник для голосування
vote_name Скорочена назва голосування
date Дата в форматі yyyy-mm-dd
time Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний
aye_votes Кількість депутатів, які проголосували “ЗА”
no_votes Кількість депутатів, які проголосували “ПРОТИ”
possible_turnout Кількість діючих депутатів на момент голосування
rebellions Загальна кількість голосів, які проти лінії фракції
edited TRUE, якщо опис голосування був відредагований

  • Деталі щодо голосувань

voting_info(vote_id, "key") – видає датафрейм із деталізованою інформацією про кожне голосування.
Параметр Опис
vote_id Унікальний визначник для голосування
vote_name Скорочена назва голосування
date Дата в форматі yyyy-mm-dd
time Час голосування в форматі hh:mm AM або hh:mm PM, чи null, якщо недоступний
aye_votes Кількість депутатів, які проголосували “ЗА”
no_votes Кількість депутатів, які проголосували “ПРОТИ”
possible_turnout Кількість діючих депутатів на момент голосування
rebellions Загальна кількість голосів, які проти лінії фракції
edited TRUE, якщо опис голосування був відредагований
summary Якщо edited є TRUE, тоді це остання версія опису.
bill_id Унікальний визначник законопроекту, що пов'язаний з голосуванням
bill_number Номер законопроекту у форматі №1234
bill_title Назва законопроекту
bill_url Гіперпосилання на законопроект на сайті ВРУ

  • Сукупність політик до яких підв'язане голосування

voting_policies(vote_id, "key") – видає датафрейм із сукупністю політик, до яких підв`язане певне голосування.
Параметр Опис
vote_id Унікальний визначник для голосування
vote_name Скорочена назва голосування
date Дата в форматі yyyy-mm-dd
bill_number Номер законопроекту у форматі №1234
policy_id Унікальний визначник для політики
policy_name Коротка назва політики
description Більше деталей про цю політику
provisional TRUE або FALSE (проект політики, яка ще не завершена і не відображається за замовчуванням)
vote Кожне голосування має відповідне vote
strong TRUE або FALSE. Показує важливість голосування

  • Голосування депутатів

voting_mps(vote_id, "key")`** – видає датафрейм із голосуванням кожного з депутатів щодо певного голосування.
Параметр Опис
vote_id Унікальний визначник для голосування
vote_name Скорочена назва голосування
bill_id Унікальний визначник законопроекту, що пов'язаний з голосуванням
bill_number Номер законопроекту у форматі №1234
bill_title Назва законопроекту
date Дата в форматі yyyy-mm-dd
mp_id Унікальний визначник для кожного депутата
mp_name Ім'я та прізвище нардепа
party Фракційність парламентаря
electorate Спосіб обрання депутата: список/назва області
vote Голосування депутата: aye, against, not voting, abstention