Улучшение помощи в R

Question

Я всегда блуждаю, что другие люди говорят о помощи R. Наконец, после нескольких лет использования, я решил, что, вероятно, пора попытаться что-то предпринять, потому что ощущение зубов зубов не исчезает с годами использования. :) Более того, я думаю, что это одна из немногих вещей, где R не подбрасывает задницы другим статистическим программам. Итак, к сути:

У меня возникает чувство (по опыту обучения языкам программирования, когда я не программист, а экономист/статистик), что структура помощи действительно помогает, и я хотел бы, чтобы она проходила путь

• базовый синтаксис (по основной я действительно имею в виду только необходимые аргументы)
• пример для «чайников», чтобы увидеть, что он делает
• щелчка здесь, если вы-хотите-to- ноу-меню/кнопка

Лучшая документация, которую я когда-либо использовал, вероятно, является одной из Mathematica, ищите пример здесь - хорошо, потому что я новичок, это мешает мне публиковать более двух ссылок, поэтому найдите ссылку вольфрама для команды Fit (это как-то связано к материалу ниже).

Так что я сделал то, что я взял файл справки R для финишных линейных моделей (http://stat.ethz.ch/R-manual/R-patched/library/stats/html/lm.html) и поместил его в более удобочитаемую форму для меня. Итак, я построил другую версию (на самом деле два) на http://pinda.sifruje.cz/. «Оригинал» - это тот же текст, и только некоторые основные вещи решены (на моем 27-дюймовом мониторе, если я сделаю полный экран браузера, оригинальная справка почти нечитаема, потому что она простирается от одного конца до другого. есть некоторые довольно хорошие шрифты, так почему бы не использовать их, вот Linux Biolinum, и я сделал некоторые для меня эстетические изменения ...). «Пользовательский» идет немного глубже и пытается реализовать немного больше моих мыслей. Кнопки действительно сделаны быстро и только в качестве примера. Кроме того, я не утверждаю, что код в любом случае хорош, я потратил, как час или два, просто распиливая кусочки, которые уже лежали вокруг Интернета. Просто возьмите это как демонстрацию.

Что бы я хотел получить от вас, это ваше мнение по этой теме. Материал, который я сделал, довольно легко сделать даже алгоритмически (какой-то синтаксический анализатор, возможно, проанализирует существующие файлы справки). Единственное добавленное значение здесь делает важный материал более заметным. Я также добавил пример «манекенов».

Так что, пожалуйста, скажите мне, что вы думаете. Я немного занят, и если я что-нибудь с этим сделаю, я бы хотел, чтобы он задумался заранее. Также, если кто-то будет заинтересован в помощи, или если он будет работать с похожим проектом, скажите мне.

Thanks, Tomas.

Answer 1

R справочная система не «подбрасывает задницу» по сравнению с другими статистическими пакетами?

О каких других пакетах мы говорим? Stata? SAS !? Что такое «хорошая» справочная система, очень субъективна. Некоторые будут призывать к многословию, некоторые скажут скупость.

Действительно, многие записи справки R могут казаться загадочными. Взято из «Описание» функции сл() (относительно простая функция):..

«Generate регулярные последовательности„след“является стандартным общим методом в по умолчанию„seq.int“является примитив, который может быть намного быстрее , но имеет несколько ограничений.«Seq_along» и «seq_len» очень быстрых примитивы для двух общих случаев.»

Первое предложение описывает все, что вам нужно знать. Остальной очень непонятная, пока вы не начнете учить определения языка. Кроме того, вы не нужно понимать эту информацию для простого использования большинства функций. Это становится актуальным при разработке новых методов и классов. Записи справки не предназначены для чтения целиком. Это зависит от вашей цели.

"R Language Definition" руководство пользователя является хорошим введением в эту терминологию.

Я не сомневаюсь что в официальную документацию может быть внесено несколько дополнительных примеров. То, что проницательно для статистики, может быть не так для эконометрика и наоборот.