{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"# Оси: axis=0 и axis=1\n",
"\n",
"Итоги по столбцам и по строкам таблицы одним вызовом — параметр axis. Как не перепутать, какая ось какая.\n",
"\n",
"Курс NumPy · урок `np-axis` · [урок на сайте](https://ds-edu-trainer.vercel.app/courses/numpy/axis).\n",
"\n",
"Выполняйте ячейки по порядку (Shift+Enter), начиная с первой — она готовит урок. После каждого упражнения идёт\n",
"ячейка проверки: она печатает ✓ / ✗ и итог."
],
"id": "intro"
},
{
"cell_type": "code",
"metadata": {
"cellView": "form",
"jupyter": {
"source_hidden": true
}
},
"source": [
"# @title Подготовка урока — выполните эту ячейку первой\n",
"# Проверяет версии пакетов, записывает файлы данных в папку data/ и определяет _check — проверку упражнений.\n",
"import base64, os, zlib\n",
"\n",
"for _name, _min in {\"numpy\":\"2.0\"}.items():\n",
" try:\n",
" _have = __import__(_name).__version__\n",
" except ImportError:\n",
" print(f\"Нет пакета {_name}: выполните %pip install {_name} и перезапустите ядро\")\n",
" continue\n",
" if tuple(int(x) for x in _have.split(\".\")[:2]) < tuple(int(x) for x in _min.split(\".\")):\n",
" print(f\"Урок написан для {_name} {_min} и новее, у вас {_have}: выполните %pip install -U {_name} и перезапустите ядро\")\n",
"\n",
"_DATA = {\n",
" \"moscow_2025.csv\": \"\"\"\n",
"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\n",
"\"\"\",\n",
"}\n",
"os.makedirs(\"data\", exist_ok=True)\n",
"for _name, _packed in _DATA.items():\n",
" with open(os.path.join(\"data\", _name), \"wb\") as _f:\n",
" _f.write(zlib.decompress(base64.b64decode(_packed)))\n",
"print(\"Файлы данных:\", \", \".join(sorted(_DATA)))\n",
"\n",
"# ─── Проверка упражнений: тот же раннер, что у задач на сайте ───\n",
"# ─── Запуск тестов ───────────────────────────────────────────────────────────\n",
"\n",
"_TIMEOUT = 2.0 # секунд на тест; отдельный тест может задать свой: test_x.timeout = 10\n",
"\n",
"\n",
"def _call_with_timeout(target, seconds: float) -> bool:\n",
" \"\"\"Запускает target() в отдельном потоке. Возвращает False, если за seconds он не завершился.\"\"\"\n",
" import sys\n",
" import threading\n",
"\n",
" if sys.platform == \"emscripten\": # Python в браузере: потоков нет, таймаут обеспечивает страница\n",
" target()\n",
" return True\n",
" # Большой стек нужен, чтобы глубокая рекурсия давала RecursionError, а не аварийное завершение Python.\n",
" for megabytes in (256, 64, 0):\n",
" try:\n",
" threading.stack_size(megabytes * 1024 * 1024)\n",
" worker = threading.Thread(target=target, daemon=True)\n",
" worker.start()\n",
" except (ValueError, RuntimeError, MemoryError):\n",
" continue\n",
" worker.join(seconds)\n",
" return not worker.is_alive()\n",
" target() # потоки недоступны — запускаем без таймаута\n",
" return True\n",
"\n",
"\n",
"def _test_info(fn) -> dict:\n",
" \"\"\"Описание теста, его лимит времени и сообщение на случай зависания.\"\"\"\n",
" limit = getattr(fn, \"timeout\", _TIMEOUT)\n",
" hint = getattr(fn, \"timeout_hint\", \"\")\n",
" message = (\n",
" f\"тест не завершился за {limit:g} с — возможно, бесконечный цикл или рекурсия: \"\n",
" \"проверьте, что границы/аргументы изменяются на каждом шаге\" + (f\". {hint}\" if hint else \"\")\n",
" )\n",
" return {\"title\": (fn.__doc__ or fn.__name__).strip(), \"timeout\": limit, \"timeout_message\": message}\n",
"\n",
"\n",
"def _error_result(title: str, error: BaseException, user_file: str | None) -> dict:\n",
" \"\"\"Результат упавшего теста: статус, сообщение, тип исключения и строка в коде решения.\"\"\"\n",
" line = None\n",
" if user_file: # самый глубокий кадр в коде решения; ошибка внутри самих тестов — без номера строки\n",
" tb = error.__traceback__\n",
" while tb is not None:\n",
" if tb.tb_frame.f_code.co_filename == user_file:\n",
" line = tb.tb_lineno\n",
" tb = tb.tb_next\n",
" status, message = \"error\", f\"{type(error).__name__}: {error}\"\n",
" if isinstance(error, NotImplementedError):\n",
" status, message, line = \"not_written\", \"функция ещё не написана\", None\n",
" elif isinstance(error, AssertionError):\n",
" status, message = \"failed\", str(error) or \"проверка не прошла\"\n",
" elif isinstance(error, RecursionError):\n",
" message = \"RecursionError: слишком глубокая рекурсия — проверьте базовый случай и то, что задача уменьшается\"\n",
" elif isinstance(error, MemoryError) or (isinstance(error, OverflowError) and \"index-sized\" in str(error)):\n",
" message = f\"{type(error).__name__}: не хватило памяти — возможно, создаётся слишком большая структура данных\"\n",
" return {\"title\": title, \"status\": status, \"message\": message, \"error_type\": type(error).__name__, \"line\": line}\n",
"\n",
"\n",
"def _run_tests(verbose: bool = True, on_start=None, on_result=None, user_file: str | None = None) -> list[dict]:\n",
" \"\"\"Запускает тесты задачи (_TESTS — функции из tests.py) по порядку, каждый — с таймаутом.\n",
"\n",
" Возвращает список результатов: {\"title\", \"status\", \"message\", \"error_type\", \"line\"}, где status —\n",
" passed · failed · error · not_written · timeout · not_run. Если тест завис, при verbose=True печатает\n",
" итог и завершает процесс: зависший поток остановить нельзя. on_start(i) и on_result(i, результат)\n",
" вызываются по мере выполнения; user_file — имя файла с кодом решения для номеров строк в ошибках.\n",
" \"\"\"\n",
" import os\n",
" import sys\n",
"\n",
" if verbose:\n",
" try: # ✓ и кириллица в консоли Windows со старой кодировкой\n",
" sys.stdout.reconfigure(encoding=\"utf-8\")\n",
" except Exception: # noqa: BLE001 — reconfigure может не быть (перенаправленный вывод, браузер)\n",
" pass\n",
"\n",
" tests = list(_TESTS)\n",
" results: list[dict] = []\n",
" not_written = hung = False\n",
" for index, fn in enumerate(tests):\n",
" info = _test_info(fn)\n",
" outcome: dict = {}\n",
"\n",
" def target(fn=fn, outcome=outcome):\n",
" try:\n",
" fn()\n",
" except BaseException as e:\n",
" outcome[\"error\"] = e\n",
"\n",
" if on_start:\n",
" on_start(index)\n",
" if not _call_with_timeout(target, info[\"timeout\"]):\n",
" results.append({\"title\": info[\"title\"], \"status\": \"timeout\", \"message\": info[\"timeout_message\"], \"error_type\": None, \"line\": None})\n",
" for other in tests[index + 1:]:\n",
" results.append({\"title\": _test_info(other)[\"title\"], \"status\": \"not_run\", \"message\": \"не запускался: предыдущий тест завис\", \"error_type\": None, \"line\": None})\n",
" hung = True\n",
" break\n",
" error = outcome.get(\"error\")\n",
" if error is None:\n",
" result = {\"title\": info[\"title\"], \"status\": \"passed\", \"message\": \"\", \"error_type\": None, \"line\": None}\n",
" else:\n",
" result = _error_result(info[\"title\"], error, user_file)\n",
" not_written = not_written or result[\"status\"] == \"not_written\"\n",
" results.append(result)\n",
" if on_result:\n",
" on_result(index, result)\n",
"\n",
" if not_written: # пока функция не написана, «даром» пройденные тесты не засчитываются\n",
" for r in results:\n",
" if r[\"status\"] == \"passed\":\n",
" r.update(status=\"not_written\", message=\"не засчитан, пока функция не написана\")\n",
" for r in results:\n",
" if len(r[\"message\"]) > 300:\n",
" r[\"message\"] = r[\"message\"][:300] + \"…\"\n",
"\n",
" if verbose:\n",
" if not_written:\n",
" print(\"Функция ещё не написана — замените raise NotImplementedError своим кодом.\\n\")\n",
" for r in results:\n",
" mark = {\"passed\": \"✓\", \"not_run\": \"–\"}.get(r[\"status\"], \"✗\")\n",
" print(f\"{mark} {r['title']}\")\n",
" if r[\"message\"]:\n",
" print(f\" {r['message']}\")\n",
" passed = sum(r[\"status\"] == \"passed\" for r in results)\n",
" print(\"─\" * 40)\n",
" print(f\"Прошло {passed} из {len(results)}\" + (\" — всё верно!\" if passed == len(results) else \"\"))\n",
" if hung:\n",
" print(\"Выполнение остановлено: один из тестов завис.\")\n",
" sys.stdout.flush()\n",
" os._exit(1)\n",
" return results\n",
"\n",
"\n",
"def _check(*tests, names=()):\n",
" \"\"\"Запускает проверки упражнения и печатает ✓ / ✗ и итог — как на сайте.\"\"\"\n",
" for name in names:\n",
" if \".\" in name: # «Класс.метод» из заготовки: класс должен быть объявлен\n",
" if not isinstance(globals().get(name.split(\".\")[0]), type):\n",
" print(f\"✗ класс {name.split('.')[0]} не объявлен — выполните ячейку упражнения\")\n",
" return\n",
" continue\n",
" if name not in globals():\n",
" print(f\"✗ переменная {name} не создана — выполните ячейку упражнения\")\n",
" return\n",
" if globals()[name] is Ellipsis:\n",
" print(f\"✗ {name} пока равна ... — замените многоточие своим кодом\")\n",
" return\n",
" globals()[\"_TESTS\"] = list(tests)\n",
" _run_tests()"
],
"execution_count": null,
"outputs": [],
"id": "setup"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"`sum`, `mean`, `max` до сих пор сворачивали всю таблицу в одно число. Но у таблицы обычно спрашивают другое:\n",
"сколько продал **каждый** магазин, какой была выручка **каждого** квартала. Для этого у агрегатов есть\n",
"параметр `axis` — ось, вдоль которой считать.\n",
"\n",
"Вернёмся к продажам трёх магазинов по кварталам из модуля 2:"
],
"id": "text-10"
},
{
"cell_type": "code",
"metadata": {},
"source": [
"# Магазины × кварталы\n",
"import numpy as np\n",
"\n",
"sales = np.array([\n",
" [120, 135, 150, 170], # магазин 1: кварталы 1–4\n",
" [ 90, 100, 95, 130], # магазин 2\n",
" [200, 180, 210, 250], # магазин 3\n",
"])\n",
"print(sales.shape)\n",
"print(sales.sum())"
],
"execution_count": null,
"outputs": [],
"id": "sales"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Две оси таблицы\n",
"\n",
"У двумерного массива две оси: **ось 0** идёт вниз — по номерам строк; **ось 1** идёт вправо — по номерам\n",
"столбцов, то есть вдоль строки. Номера\n",
"осей совпадают с позициями в форме `(3, 4)`: ось 0 длиной 3, ось 1 длиной 4.\n",
"\n",
"`axis` — это ось, **которую сворачивают**: вдоль неё идёт сложение, и она исчезает из результата."
],
"id": "text-18"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"*Схема — в уроке на сайте: https://ds-edu-trainer.vercel.app/courses/numpy/axis*"
],
"id": "component-27"
},
{
"cell_type": "code",
"metadata": {},
"source": [
"# sum(axis=0) и sum(axis=1)\n",
"print(sales.sum(axis=0)) # по каждому кварталу (столбцу)\n",
"print(sales.sum(axis=1)) # по каждому магазину (строке)"
],
"execution_count": null,
"outputs": [],
"id": "axis-sums"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"- `sales.sum(axis=0)` — складываем вниз, строки исчезают: сумма для **каждого столбца** — квартала. Форма\n",
" `(3, 4)` → `(4,)`.\n",
"- `sales.sum(axis=1)` — складываем вправо, столбцы исчезают: сумма для **каждой строки** — магазина. Форма\n",
" `(3, 4)` → `(3,)`."
],
"id": "text-30"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"> **Типичная ошибка: путаница с axis.**\n",
">\n",
"> Интуиция часто подсказывает наоборот: «axis=0 — это строки, значит, итог по строкам». Но итог **по каждой\n",
"> строке** — это `axis=1`. Надёжный способ не ошибиться — смотреть на форму: число, которое вы указали в `axis`,\n",
"> пропадает из формы. Нужен результат длиной «сколько строк» — сворачивайте столбцы, `axis=1`."
],
"id": "component-36"
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Упражнение 1. Продажи каждого магазина\n",
"\n",
"Сохраните в `store_totals` продажи каждого магазина за год — три числа, по одному на строку таблицы `sales`.\n",
"\n",
"Подсказка 1
\n",
"\n",
"Результат — по строке, значит, сворачиваем столбцы.\n",
"\n",
"Подсказка 2
\n",
"\n",
"`sales.sum(axis=1)`.\n",
"\n",
"Решение
\n",
"\n",
"```python\n",
"store_totals = sales.sum(axis=1)\n",
"```\n",
"\n",
"Подсказка 1
\n",
"\n",
"Результат — по столбцу, значит, сворачиваем строки: `axis=0`.\n",
"\n",
"Решение
\n",
"\n",
"```python\n",
"quarter_avg = sales.mean(axis=0)\n",
"```\n",
"\n",
"Ответ
\n",
"\n",
"`(4,)`\n",
"\n",
"Ось 0 — та, у которой длина 3. `axis=0` сворачивает её, остаётся ось длиной 4.\n",
"\n",
"Подсказка 1
\n",
"\n",
"Максимум каждой строки: `weeks.max(axis=1)`.\n",
"\n",
"Подсказка 2
\n",
"\n",
"Где он наибольший — `argmax`; номер недели — индекс плюс один.\n",
"\n",
"Решение
\n",
"\n",
"```python\n",
"week_max = weeks.max(axis=1)\n",
"hottest_week = week_max.argmax() + 1\n",
"```\n",
"\n",
"Подсказка 1
\n",
"\n",
"Результат — по столбцу таблицы `weeks`: сворачиваем строки.\n",
"\n",
"Решение
\n",
"\n",
"```python\n",
"by_weekday = weeks.mean(axis=0)\n",
"```\n",
"\n",
"