doubt.datasets.bike_sharing_daily

  1"""Daily bike sharing data set.
  2
  3This data set is from the UCI data set archive, with the description being the original
  4description verbatim. Some feature names may have been altered, based on the
  5description.
  6"""
  7
  8import io
  9import zipfile
 10
 11import pandas as pd
 12
 13from .dataset import BASE_DATASET_DESCRIPTION, BaseDataset
 14
 15
 16class BikeSharingDaily(BaseDataset):
 17    __doc__ = f"""
 18    Bike sharing systems are new generation of traditional bike rentals where whole
 19    process from membership, rental and return back has become automatic. Through these
 20    systems, user is able to easily rent a bike from a particular position and return
 21    back at another position. Currently, there are about over 500 bike-sharing programs
 22    around the world which is composed of over 500 thousands bicycles. Today, there
 23    exists great interest in these systems due to their important role in traffic,
 24    environmental and health issues.
 25
 26    Apart from interesting real world applications of bike sharing systems, the
 27    characteristics of data being generated by these systems make them attractive for
 28    the research. Opposed to other transport services such as bus or subway, the
 29    duration of travel, departure and arrival position is explicitly recorded in these
 30    systems. This feature turns bike sharing system into a virtual sensor network that
 31    can be used for sensing mobility in the city. Hence, it is expected that most of
 32    important events in the city could be detected via monitoring these data.
 33
 34    {BASE_DATASET_DESCRIPTION}
 35
 36    Features:
 37        instant (int):
 38            Record index
 39        season (int):
 40            The season, with 1 = winter, 2 = spring, 3 = summer and 4 = autumn
 41        yr (int):
 42            The year, with 0 = 2011 and 1 = 2012
 43        mnth (int):
 44            The month, from 1 to 12 inclusive
 45        holiday (int):
 46            Whether day is a holiday or not, binary valued
 47        weekday (int):
 48            The day of the week, from 0 to 6 inclusive
 49        workingday (int):
 50            Working day, 1 if day is neither weekend nor holiday, otherwise 0
 51        weathersit (int):
 52            Weather, encoded as
 53
 54            1. Clear, few clouds, partly cloudy
 55            2. Mist and cloudy, mist and broken clouds, mist and few clouds
 56            3. Light snow, light rain and thunderstorm and scattered clouds, light rain
 57            and scattered clouds
 58            4. Heavy rain and ice pallets and thunderstorm and mist, or snow and fog
 59        temp (float):
 60            Max-min normalised temperature in Celsius, from -8 to +39
 61        atemp (float):
 62            Max-min normalised feeling temperature in Celsius, from -16 to +50
 63        hum (float):
 64            Scaled max-min normalised humidity, from 0 to 1
 65        windspeed (float):
 66            Scaled max-min normalised wind speed, from 0 to 1
 67
 68    Targets:
 69        casual (int):
 70            Count of casual users
 71        registered (int):
 72            Count of registered users
 73        cnt (int):
 74            Sum of casual and registered users
 75
 76    Source:
 77        https://archive.ics.uci.edu/ml/datasets/Bike+Sharing+Dataset
 78
 79    Examples:
 80        Load in the data set::
 81
 82            >>> dataset = BikeSharingDaily()
 83            >>> dataset.shape
 84            (731, 15)
 85
 86        Split the data set into features and targets, as NumPy arrays::
 87
 88            >>> X, y = dataset.split()
 89            >>> X.shape, y.shape
 90            ((731, 12), (731, 3))
 91
 92        Perform a train/test split, also outputting NumPy arrays::
 93
 94            >>> train_test_split = dataset.split(test_size=0.2, random_seed=42)
 95            >>> X_train, X_test, y_train, y_test = train_test_split
 96            >>> X_train.shape, y_train.shape, X_test.shape, y_test.shape
 97            ((574, 12), (574, 3), (157, 12), (157, 3))
 98
 99        Output the underlying Pandas DataFrame::
100
101            >>> df = dataset.to_pandas()
102            >>> type(df)
103            <class 'pandas.core.frame.DataFrame'>
104    """
105
106    _url = (
107        "https://archive.ics.uci.edu/ml/machine-learning-databases/"
108        "00275/Bike-Sharing-Dataset.zip"
109    )
110
111    _features = range(12)
112    _targets = [12, 13, 14]
113
114    def _prep_data(self, data: bytes) -> pd.DataFrame:
115        """Prepare the data set.
116
117        Args:
118            data (bytes): The raw data
119
120        Returns:
121            Pandas dataframe: The prepared data
122        """
123        # Convert the bytes into a file-like object
124        buffer = io.BytesIO(data)
125
126        # Unzip the file and pull out day.csv as a string
127        with zipfile.ZipFile(buffer, "r") as zip_file:
128            csv = zip_file.read("day.csv").decode("utf-8")
129
130        # Convert the string into a file-like object
131        csv_file = io.StringIO(csv)
132
133        # Read the file-like object into a dataframe
134        cols = [0] + list(range(2, 16))
135        df = pd.read_csv(csv_file, usecols=cols)
136        return df