Skip to content

Commit eb3fa45

Browse files
actions-useractions-user
committed
source commit: 863adc6 
0 parents  commit eb3fa45

21 files changed

Lines changed: 2227 additions & 0 deletions

‎CODE_OF_CONDUCT.md‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
---
2+
title: "Contributor Code of Conduct"
3+
---
4+
5+
As contributors and maintainers of this project,
6+
we pledge to follow the [The Carpentries Code of Conduct][coc].
7+
8+
Instances of abusive, harassing, or otherwise unacceptable behavior
9+
may be reported by following our [reporting guidelines][coc-reporting].
10+
11+
[coc]: https://docs.carpentries.org/topic_folders/policies/code-of-conduct.html
12+
[coc-reporting]: https://docs.carpentries.org/topic_folders/policies/incident-reporting.html
13+
14+
15+

‎LICENSE.md‎

Lines changed: 81 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,81 @@
1+
---
2+
title: "Licenses"
3+
---
4+
5+
## Instructional Material
6+
7+
All Carpentries (Software Carpentry, Data Carpentry, and Library Carpentry)
8+
instructional material is made available under the [Creative Commons
9+
Attribution license][cc-by-human]. The following is a human-readable summary of
10+
(and not a substitute for) the [full legal text of the CC BY 4.0
11+
license][cc-by-legal].
12+
13+
You are free:
14+
15+
- to **Share**\---copy and redistribute the material in any medium or format
16+
- to **Adapt**\---remix, transform, and build upon the material
17+
18+
for any purpose, even commercially.
19+
20+
The licensor cannot revoke these freedoms as long as you follow the license
21+
terms.
22+
23+
Under the following terms:
24+
25+
- **Attribution**\---You must give appropriate credit (mentioning that your work
26+
is derived from work that is Copyright (c) The Carpentries and, where
27+
practical, linking to [https://carpentries.org/](https://carpentries.org/)), provide a [link to the
28+
license][cc-by-human], and indicate if changes were made. You may do so in
29+
any reasonable manner, but not in any way that suggests the licensor endorses
30+
you or your use.
31+
32+
- **No additional restrictions**\---You may not apply legal terms or
33+
technological measures that legally restrict others from doing anything the
34+
license permits. With the understanding that:
35+
36+
Notices:
37+
38+
- You do not have to comply with the license for elements of the material in
39+
the public domain or where your use is permitted by an applicable exception
40+
or limitation.
41+
- No warranties are given. The license may not give you all of the permissions
42+
necessary for your intended use. For example, other rights such as publicity,
43+
privacy, or moral rights may limit how you use the material.
44+
45+
## Software
46+
47+
Except where otherwise noted, the example programs and other software provided
48+
by The Carpentries are made available under the [OSI][osi]\-approved [MIT
49+
license][mit-license].
50+
51+
Permission is hereby granted, free of charge, to any person obtaining a copy of
52+
this software and associated documentation files (the "Software"), to deal in
53+
the Software without restriction, including without limitation the rights to
54+
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
55+
of the Software, and to permit persons to whom the Software is furnished to do
56+
so, subject to the following conditions:
57+
58+
The above copyright notice and this permission notice shall be included in all
59+
copies or substantial portions of the Software.
60+
61+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
62+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
63+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
64+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
65+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
66+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
67+
SOFTWARE.
68+
69+
## Trademark
70+
71+
"The Carpentries", "Software Carpentry", "Data Carpentry", and "Library
72+
Carpentry" and their respective logos are registered trademarks of
73+
[The Carpentries, Inc.][carpentries].
74+
75+
[cc-by-human]: https://creativecommons.org/licenses/by/4.0/
76+
[cc-by-legal]: https://creativecommons.org/licenses/by/4.0/legalcode
77+
[mit-license]: https://opensource.org/licenses/mit-license.html
78+
[carpentries]: https://carpentries.org
79+
[osi]: https://opensource.org
80+
81+

‎config.yaml‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
#------------------------------------------------------------
2+
# Values for this lesson.
3+
#------------------------------------------------------------
4+
5+
# Which carpentry is this (swc, dc, lc, or cp)?
6+
# swc: Software Carpentry
7+
# dc: Data Carpentry
8+
# lc: Library Carpentry
9+
# cp: Carpentries (to use for instructor training for instance)
10+
# incubator: The Carpentries Incubator
11+
carpentry: 'dc'
12+
13+
# Overall title for pages.
14+
title: 'Social Science Workshop Overview'
15+
16+
# Date the lesson was created (YYYY-MM-DD, this is empty by default)
17+
created: '2017-05-25'
18+
19+
# Comma-separated list of keywords for the lesson
20+
keywords: 'software, data, lesson, The Carpentries' # FIXME
21+
22+
# Life cycle stage of the lesson
23+
# possible values: pre-alpha, alpha, beta, stable
24+
life_cycle: 'stable'
25+
26+
# License of the lesson
27+
license: 'CC-BY 4.0'
28+
29+
# Link to the source repository for this lesson
30+
source: 'https://github.com/datacarpentry/socialsci-workshop'
31+
32+
# Default branch of your lesson
33+
branch: 'main'
34+
35+
# Who to contact if there are any issues
36+
contact: 'team@carpentries.org'
37+
38+
# Navigation ------------------------------------------------
39+
#
40+
# Use the following menu items to specify the order of
41+
# individual pages in each dropdown section. Leave blank to
42+
# include all pages in the folder.
43+
#
44+
# Example -------------
45+
#
46+
# episodes:
47+
# - introduction.md
48+
# - first-steps.md
49+
#
50+
# learners:
51+
# - setup.md
52+
#
53+
# instructors:
54+
# - instructor-notes.md
55+
#
56+
# profiles:
57+
# - one-learner.md
58+
# - another-learner.md
59+
60+
# Order of episodes in your lesson
61+
episodes:
62+
- introduction.Rmd
63+
64+
# Information for Learners
65+
learners:
66+
67+
# Information for Instructors
68+
instructors:
69+
70+
# Learner Profiles
71+
profiles:
72+
73+
# Customisation ---------------------------------------------
74+
#
75+
# This space below is where custom yaml items (e.g. pinning
76+
# sandpaper and varnish versions) should live
77+
78+
79+
url: 'https://datacarpentry.github.io/socialsci-workshop'
80+
analytics: 'carpentries'
81+
lang: 'en'
82+
overview: true

‎data.md‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
---
2+
title: Workshop data
3+
permalink: /data/
4+
---
5+
6+
All of the social science lessons use the same data set throughout.
7+
The data is tabular (rows and columns), similar in structure to what
8+
you might have in a spreadsheet.
9+
10+
## The SAFI Teaching Database
11+
12+
Available on FigShare: [https://figshare.com/articles/SAFI\_Survey\_Results/6262019](https://figshare.com/articles/SAFI_Survey_Results/6262019)
13+
14+
**CITATION:** Woodhouse, Philip; Veldwisch, Gert Jan; Brockington, Daniel; Komakech, Hans C.; Manjichi, Angela; Venot, Jean-Philippe (2018): SAFI Survey Results. doi:10.6084/m9.figshare.6262019.v1
15+
16+
SAFI (Studying African Farmer-Led Irrigation) is a currently running
17+
project which is looking at farming and irrigation methods. This is
18+
survey data relating to households and agriculture in Tanzania and
19+
Mozambique. The survey data was collected through interviews
20+
conducted between November 2016 and June 2017 using forms downloaded
21+
to Android Smartphones. The survey forms were created using the ODK
22+
(Open Data Kit) software via an Excel spreadsheet. The collected data
23+
is then sent back to a central server. The server can be used to
24+
download the collected data in both JSON and CSV formats. This is a
25+
teaching version of the collected data that we will be using. It is not the full dataset.
26+
27+
The survey covered such things as; household features (e.g.
28+
construction materials used, number of household members),
29+
agricultural practices (e.g. water usage), assets (e.g. number and
30+
types of livestock) and details about the household members.
31+
32+
The basic teaching dataset used in these lessons is a JSON
33+
formatted dataset which is used directly in the Python lesson. For
34+
the other lessons a subset of the JSON dataset is used and has been
35+
converted into CSV format.
36+
37+
The individual fields and the survey questions asked to produce the
38+
data in the CSV formatted version are given below. We will only
39+
reference a subset of the fields in the lessons.
40+
41+
| column\_name | description |
42+
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
43+
| key\_id | Added to provide a unique Id for each observation. (The InstanceID field does this as well but it is not as convenient to use) |
44+
| interview\_date | Date of interview |
45+
| quest\_no | Questionnaire number |
46+
| start | Timestamp of start of interview |
47+
| end | Timestamp of end of interview |
48+
| province | Province name |
49+
| district | District name |
50+
| ward | Ward name |
51+
| village | Village name |
52+
| years\_farm | Number of years the household have been farming in this area |
53+
| agr\_assoc | Does the head of the household belong to an agricultural association? |
54+
| no\_membrs | How many members in the household? |
55+
| \_members\_count | Internal count of members |
56+
| remittance\_money | Is there any financial assistance from family members not living on the farm |
57+
| years\_liv | How many years have you been living in this village or neighboring village? |
58+
| parents\_liv | Did your parents live in this village or neighboring village? |
59+
| sp\_parents\_liv | Did your spouse's parents live in this village or neighbouring village? |
60+
| grand\_liv | Did your grandparents live in this village or neighbouring village? |
61+
| sp\_grand\_liv | Did your spouse's grandparents live in this village or neighbouring village? |
62+
| respondent\_roof\_type | What type of roof does their house have? |
63+
| respondent\_wall\_type | What type of walls does their house have (from list) |
64+
| respondent\_wall\_type\_other | What type of walls does their house have (not on list) |
65+
| respondent\_floor\_type | What type of floor does their house have |
66+
| window\_type | Does the house have glass in at least one window? |
67+
| buildings\_in\_compound | How many buildings are in the compound? Do not include stores, toilets or temporary structures. |
68+
| rooms | How many rooms in the main house are used for sleeping? |
69+
| other\_buildings | Does the DU own any other buildings other than those on this plot |
70+
| no\_plots | How many plots were cultivated in the last 12 months? |
71+
| plots\_count | Internal count of plots |
72+
| water\_use | Do you bring water to your fields, stop water leaving your fields or drain water out of any of your fields? |
73+
| no\_group\_count | How many plots are irrigated? |
74+
| yes\_group\_count | How many plots are not irrigated? |
75+
| no\_enough\_water | Are there months when you cannot get enough water for your crops? Indicate which months. |
76+
| months\_no\_water | Please select the months |
77+
| period\_use | For how long have you been using these methods of watering crops? (years) |
78+
| exper\_other | Do you have experience of such methods on other farms? |
79+
| other\_meth | Have you used other methods before? |
80+
| res\_change | Why did you change the way of watering your crops? |
81+
| memb\_assoc | Are you a member of an irrigation association? |
82+
| resp\_assoc | Do you have responsibilities in that association? |
83+
| fees\_water | Do you pay fees to use water? |
84+
| affect\_conflicts | Have you been affected by conflicts with other irrigators in the area? |
85+
| need\_money | If you started or changed the way you water your crops recently, did you need any money for it? |
86+
| money\_source | Where did the money came from? (list) |
87+
| money\_source\_other | Where did the money came from? (not on list) |
88+
| crops\_contr | Considering fields where you have applied water, how much do those crops contribute to your overall income? |
89+
| emply\_lab | In the most recent cultivation season, did you employ day labourers on fields? |
90+
| du\_labour | In the most recent cultivation season, did anyone in the household undertake day labour work on other farm? |
91+
| liv\_owned | What types of livestock do you own? (list) |
92+
| liv\_owned\_other | What types of livestock do you own? (not on list) |
93+
| liv\_count | Livestock count |
94+
| poultry | Own poultry? |
95+
| du\_look\_aftr\_cows | At the present time, does the household look after cows for someone else in return for milk or money? |
96+
| items\_owned | Which of the following items are owned by the household? (list) |
97+
| items\_owned\_other | Which of the following items are owned by the household? (not on list) |
98+
| no\_meals | How many meals do people in your household normally eat in a day? |
99+
| months\_lack\_food | Indicate which months, In the last 12 months have you faced a situation when you did not have enough food to feed the household? |
100+
| no\_food\_mitigation | When you have faced such a situation what do you do? |
101+
| gps\_Latitude | Location latitude (provided by smartphone) |
102+
| gps\_Longitude | Location longitude (provided by smartphone) |
103+
| gps\_Altitude | Location altitude (provided by smartphone) |
104+
| gps\_Accuracy | Location accuracy (provided by smartphone) |
105+
| instanceID | Unique identifier for the form data submission |
106+
107+

0 commit comments

Comments
 (0)