utils

Utilities - Helper functions.

Source homepage

homepage_url()

Specify the homepage URL of the data source.

Data directory

cd_dat(*sub_dir[, dat_dir, mkdir])

Change directory to dat_dir/ and sub-directories within a package.

Converters

mile_chain_to_nr_mileage(miles_chains)

Convert mileage data in the form ‘<miles>.<chains>’ to Network Rail mileage.

nr_mileage_to_mile_chain(str_mileage)

Convert Network Rail mileage to the form ‘<miles>.<chains>’.

nr_mileage_str_to_num(str_mileage)

Convert string-type Network Rail mileage to numerical-type one.

nr_mileage_num_to_str(num_mileage)

Convert numerical-type Network Rail mileage to string-type one.

nr_mileage_to_yards(nr_mileage)

Convert Network Rail mileages to yards.

yards_to_nr_mileage(yards)

Convert yards to Network Rail mileages.

shift_num_nr_mileage(nr_mileage, shift_yards)

Shift Network Rail mileage by given yards.

year_to_financial_year(date)

Convert calendar year of a given date to Network Rail financial year.

Parsers

parse_tr(header, trs)

Parse a list of parsed HTML <tr> elements.

parse_table(source[, parser])

Parse HTML <tr> elements for creating a data frame.

parse_location_name(location_name)

Parse location name (and its associated note).

parse_date(str_date[, as_date_type])

Parse a date.

Retrieval of useful information

fake_requests_headers([randomized])

Make a fake HTTP headers for requests.get.

get_last_updated_date(url[, parsed, …])

Get last update date.

get_catalogue(page_url[, update, …])

Get the catalogue for a class.

get_category_menu(menu_url[, update, …])

Get a menu of the available classes.

get_station_data_catalogue(source_url, …)

Get catalogue of railway station data.

get_track_diagrams_items(source_url, source_key)

Get catalogue of track diagrams.

Rectification of location names

fetch_location_names_repl_dict([k, regex, …])

Create a dictionary for rectifying location names.

update_location_name_repl_dict(new_items, regex)

Update the location-name replacement dictionary in the package data.

Fixers

fix_num_stanox(stanox_code)

Fix ‘STANOX’ if it is loaded as numbers.

Misc

is_str_float(str_val)

Check if a string-type variable can express a float-type value.