Skip to content

Commit 8b0f476

Browse files
committed
Renamed and reorganized files, updated readme
1 parent 52c32e7 commit 8b0f476

20 files changed

+58
-29
lines changed

README.md

Lines changed: 58 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -33,85 +33,114 @@ Here's a quick summary of the endpoints I tend to use, and some of their documen
3333

3434
## Scripts
3535

36-
### [authorizeHeadings.py](authorizeFASTAndLCAuthorityHeadings.py)
36+
### searchForStringMatch
37+
38+
#### [authorizeFASTAndLCAuthorityHeadings.py](searchForStringMatch/authorizeFASTAndLCAuthorityHeadings.py)
3739
**Starting data:** A spreadsheet that searches a string heading in LCNAF and FAST and produces a URI if there is an exact match.<br>
3840
**APIs:** Library of Congress Authorities, FAST (SRUSearch)
3941

4042
Confirms the heading is authorized by retrieving the URIs and label from the APIs.
4143

42-
### [searchForStringMatch_FAST.py](searchForStringMatchInFAST.py)
44+
#### [searchForStringMatchInFAST.py](searchForStringMatch/searchForStringMatchInFAST.py)
4345
**Starting data:** A spreadsheet with strings of possible FAST headings.<br>
4446
**APIs:** FAST (Autosuggest), FAST (SRUSearch)
4547

4648
Finds exact and close matches to FAST subject headings.
4749

48-
### [convertIdentifiersToURI.py](convertFASTAndVIAFIdentifiersToURI.py)
50+
### getItemMetadata
51+
52+
#### [getEuropeanaData.py](getItemMetadata/getEuropeanaData.py)
53+
**Starting data**: Europeana item identifier as variable `item`.<br>
54+
**APIs**: Europeana
55+
56+
Downloads item record in JSON-LD, and saves as file "query.json."
57+
58+
#### [getItemMetadataFromInternetArchive.py](getItemMetadata/getItemMetadataFromInternetArchive.py)
59+
**Starting data**: Internet Archive item identifier as variable `internet_id`.<br>
60+
**APIs**: Internet Archive
61+
62+
Downloads item record in JSON and saves metadata in CSV.
63+
64+
#### [getPropertiesWikiData.py](getItemMetadata/getPropertiesWikiData.py)
65+
**Starting data**: Entity id from WikiData.<br>
66+
**APIs**: Wikidata
67+
68+
Finds properties of entity and saves in CSV.
69+
70+
71+
### Convert
72+
73+
#### [convertFASTAndVIAFIdentifiersToURI.py](convert/convertFASTAndVIAFIdentifiersToURI.py)
4974
**Starting data**: A spreadsheet with FAST or VIAF identifiers.<br>
5075
**APIs:** none
5176

5277
Converts FAST and VIAF identifiers to URIs.
5378

54-
### [convertYearsToFASTDecades.py](convertYearsToFASTDecades.py)
79+
#### [convertLCNAFToGeonames.py](convert/convertLCNAFToGeonames.py)
80+
**Starting data**: A spreadsheet with geographic headers (from FAST or LCNAF).<br>
81+
**APIs**: FAST (read), Library of Congress Authorities, GeoNames
82+
83+
Convert geographic names from LCNAF to geonames identifiers. Example: Baltimore County (Md.) n79018713 is converted to Baltimore County https://www.geonames.org/4347790. It also builds full hierarchical name: Baltimore County, Maryland, United States from GeoNames.
84+
85+
#### [convertLSCHToFAST.py](convert/convertLSCHToFAST.py)
86+
**Starting data**: A spreadsheet with Library of Congress Subject Headings.<br>
87+
**APIs**: FAST (read), Library of Congress Authorities
88+
89+
Converts LCSH to one or more FAST headings.
90+
91+
#### [convertYearsToFASTDecades.py](convert/convertYearsToFASTDecades.py)
5592
**Starting data**: A spreadsheet with year dates from 1800s onwards.<br>
5693
**APIs**: none
5794

5895
Converts years into written out decades as given in FAST.
5996

60-
### [getAlternativeIdentifiers_FAST.py](getAlternativeIdentifiersFromFAST.py)
97+
### getAdditionalPropertiesFromIdentifiers
98+
99+
#### [getAlternativeIdentifiersFromFAST.py](getAdditionalPropertiesFromIdentifier/getAlternativeIdentifiersFromFAST.py)
61100
**Starting data**: A spreadsheet with FAST identifiers.<br>
62101
**APIs**: FAST (read)
63102

64103
Retrieves alternative identifiers from other authorities (VIAF, GeoNames, LCSH, etc.) given in FAST records.
65104

66-
### [getAuthoritiesNames.py](getURIsFromLabel_LCAuthoritiesAndVIAF.py)
67-
**Starting data**: A spreadsheet with Library of Congress Names.<br>
68-
**APIs**: Library of Congress Authorities
69-
70-
Retrieves the LCNAF URI for the searched named and grabbed alternative identifiers from other authorities (FAST and LCSH) in the records.
71-
72-
### [getEuropeanaData.py](getEuropeanaData.py)
73-
**Starting data**: Europeana item identifier as variable `item`.<br>
74-
**APIs**: Europeana
75-
76-
Downloads item record in JSON-LD, and saves as file "query.json."
77-
78-
### [getFacetForTerms_FAST.py](getFacetForTerms_FAST.py)
105+
#### [getFacetForTerms_FAST.py](getAdditionalPropertiesFromIdentifier/getFacetForTerms_FAST.py)
79106
**Starting data**: A spreadsheet with FAST identifiers.<br>
80107
**APIs**: FAST (read)
81108

82109
Converts the FAST identifier to a link, gets the rdf.xml record, and extracts the facet information (topical, geographical, corporate name, meeting or event, personal name, uniform title, form, period).
83110

84-
### [getFacetForTerms_VIAF.py](getFacetForTerms_VIAF.py)
111+
#### [getFacetForTerms_VIAF.py](getAdditionalPropertiesFromIdentifier/getFacetForTerms_VIAF.py)
85112
**Starting data**: A spreadsheet of VIAF URIs formatted like https://viaf.org/viaf/149920363. The script won't work if there is an ending dash (ex: https://viaf.org/viaf/149920363/).<br>
86113
**APIs**: VIAF, Library of Congress Authorities
87114

88115
Takes a list of VIAF URIs from a spreadsheet, finds the LCNAF authority record, and extracts the facet information from the rdf.xml record.
89116

90-
### [getGeoNames_LCNAF.py](getGeoNames_LCNAF.py)
91-
**Starting data**: A spreadsheet with geographic headers (from FAST or LCNAF).<br>
92-
**APIs**: FAST (read), Library of Congress Authorities, GeoNames
93-
94-
Convert geographic names from LCNAF to geonames identifiers. Example: Baltimore County (Md.) n79018713 is converted to Baltimore County https://www.geonames.org/4347790. It also builds full hierarchical name: Baltimore County, Maryland, United States from GeoNames.
95-
96-
### [getLabelFromURI.py](getLabelFromURI.py)
117+
#### [getLabelFromURI.py](getAdditionalPropertiesFromIdentifier/getLabelFromURI.py)
97118
**Starting data**: A spreadsheet with URIs from the FAST, Library of Congress Authorities, GeoNames, VIAF, or AAT vocabularies.<br>
98119
**APIs:** FAST (read), Library of Congress Authorities, GeoNames, VIAF, AAT
99120

100121
Retrieves the authorized heading or label from the correct vocabulary using the URIs.
101122

102-
### [getNameComponents_VIAF.py](getNameComponents_VIAF.py)
123+
#### [getNameComponents_VIAF.py](getAdditionalPropertiesFromIdentifier/getNameComponents_VIAF.py)
103124
**Starting data**: A spreadsheet of VIAF URIs formatted like https://viaf.org/viaf/149920363. The script won't work if there is an ending dash (ex: https://viaf.org/viaf/149920363/).<br>
104125
**APIs:** VIAF, Library of Congress Authorities
105126

106127
Takes a list of VIAF URIs from a spreadsheet, finds the LCNAF authority record, and extracts the name components from the .marcxml.xml record.
107128

108-
### [getURIsFromLabel_AAT.py](getURIsFromLabel_AAT.py)
129+
### Get URIs from authorized headings or labels
130+
131+
#### [getURIsFromLabel_LCAuthoritiesAndVIAF.py](getURIsFromLabel/getURIsFromLabel_LCAuthoritiesAndVIAF.py)
132+
**Starting data**: A spreadsheet with Library of Congress Names.<br>
133+
**APIs**: Library of Congress Authorities
134+
135+
Retrieves the LCNAF URI for the searched named and grabbed alternative identifiers from other authorities (FAST and LC Authorities (LCNAF, LCSH, LCGFT)) in the records.
136+
137+
#### [getURIsFromLabel_AAT.py](getURIsFromLabel/getURIsFromLabel_AAT.py)
109138
**Starting data**: String in variable `label_search`.<br>
110139
**APIs**: AAT
111140

112141
Retrieves AAT URI by searching for the label in the API.
113142

114-
### [getURIsFromLabel_FAST.py](getURIsFromLabel_FAST.py)
143+
#### [getURIsFromLabel_FAST.py](getURIsFromLabel/getURIsFromLabel_FAST.py)
115144
**Starting data**: A spreadsheet with FAST string headings.<br>
116145
**APIs**: FAST (read), FAST (search)
117146

File renamed without changes.
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)