Fra Fame til Python
-Python-pakken fython
lar deg hente ut data fra Fame-databaser for å jobbe med det i Python.
Mange i SSB har data lagret i Fame som de ønsker å bearbeide med Python og R. Dette er spesielt relevant når man skal flytte statistikkproduksjon til Dapla. fython
er en Python-pakke som gjør dette på en enkel måte for deg. Den lar deg eksportere data fra Fame med en enkel funksjon, og kan returnere dataene som enten CSV eller Pandas DataFrame.
Installasjon
-Pakken ligger på GitHub og kan installeres derfra. I et ssb-project installerer du ved å kjøre følgende kommando:
+Pakken er avhengig av at Fame er installert miljøet der den benyttes. Siden den er installert på sl-fame-1.ssb.no
1 så vil de færreste har behov for å installere den selv.
Skulle du likevel ønske å installere pakken selv kan det gjøres med Poetry på følgende måte:
terminal
poetry add git+https://github.com/statisticsnorway/ssb-fame-to-python.git
Pakken er også ferdiginstallert på serveren der Fame installert: sl-fame-1.ssb.no
. Dette kan være nyttig i flere sammenhenger som vi kommer inn på senere i innelegget.
Bruk av funksjonene
@@ -314,39 +326,61 @@Bruk av funksjonene
Tabell 1: Forklaring av argumentene i funksjonene til fython
-
-
+
+
+
+
Argument
Forklaring
+fame_to_csv()
+fame_to_pandas()
databases
List of Fame databases to access (with full path).
+✓
+✓
frequency
Frequency of the data (‘a’, ‘q’, ‘m’).
+✓
+✓
date_from
Start date for the data in Fame syntax (e.g., ‘2023:1’ for quarterly, ‘2023’ for annual).
+✓
+✓
date_to
End date for the data in Fame syntax (e.g., ‘2023:1’ for quarterly, ‘2023’ for annual).
+✓
+✓
search_string
-Query string for fetching specific data. The search is not case sensitive, and “^” and “?” are wildcards (for exactly one and any number of characters, respectively)
+Query string for fetching specific data. The search is not case sensitive, and “^” and “?” are wildcards (for exactly one and any number of characters, respectively)
+✓
+✓
decimals
Number of decimal places in the fetched data (default is 10).
+✓
+✓
+
+
+path
+Path to write the csv-file.
+✓
+
@@ -388,6 +422,19 @@ Eksempler
'sti/til/database1.db', 'sti/til/database2.db', 'm', '2012:1', '2022:12', 'abc?d^', 'sti/til/csv-fil.csv']
[ )
fython