Gói R đầu tiên mã nguồn để nghiên cứu để chuẩn bị viết gói riêng

Tôi đang dự định bắt đầu viết các gói R.

Tôi nghĩ rằng sẽ tốt khi nghiên cứu mã nguồn của các gói hiện có để tìm hiểu các quy ước về xây dựng gói.

Tiêu chí của tôi cho các gói tốt để nghiên cứu:

• Ý tưởng thống kê / kỹ thuật đơn giản : Vấn đề là tìm hiểu về các cơ chế xây dựng gói. Hiểu về gói không nên yêu cầu kiến ​​thức cụ thể về tên miền chi tiết về chủ đề thực tế của gói.
• Phong cách mã hóa đơn giản và thông thường : Tôi đang tìm kiếm một cái gì đó nhiều hơn một chút Hello Worldnhưng không phải là nhiều hơn nữa. Các thủ thuật và hack đột xuất sẽ gây mất tập trung khi lần đầu tiên học các gói R.
• Phong cách mã hóa tốt : Mã được viết tốt. Nó cho thấy cả sự hiểu biết về mã hóa tốt, nói chung và nhận thức về các quy ước về mã hóa trong R.

Câu hỏi:

• Những gói nào sẽ tốt để học?
• Tại sao mã nguồn gói được đề xuất sẽ tốt để nghiên cứu liên quan đến các tiêu chí được đề cập ở trên hoặc bất kỳ tiêu chí nào khác có thể có liên quan?

Cập nhật (13/12/2010) Sau những bình luận của Dirk, tôi muốn nói rõ rằng không có nghi ngờ gì nhiều gói sẽ tốt để nghiên cứu trước. Tôi cũng đồng ý rằng các gói sẽ cung cấp các mô hình cho những thứ khác nhau (ví dụ: họa tiết, lớp S3, lớp S4, kiểm tra đơn vị, Roxygen, v.v.). Tuy nhiên, sẽ rất thú vị khi đọc các đề xuất cụ thể về các gói tốt để bắt đầu và lý do tại sao chúng sẽ là các gói tốt để bắt đầu.

Tôi cũng đã cập nhật câu hỏi ở trên để chỉ "gói" chứ không phải "gói".

Tôi sẽ đề nghị nhìn vào gói sở thú vì những lý do sau:

1. Nó có một vài họa tiết được viết tốt;
2. Nó sử dụng một không gian tên sử dụng useDynLib, import, export, và S3method;
3. Nó có một số bài kiểm tra đơn vị sử dụng RUnit;
4. Nó cung cấp các ví dụ tốt về cách tạo / tài liệu các phương thức S3;
5. Nó có một số cuộc gọi đến mã C thông qua .Callgiao diện;
6. Nó chứa một bản demo (âm mưu);
7. Nó nhằm mục đích phù hợp với cài đặt R lõi (ví dụ: các chức năng hoạt động tương tự, nó không che giấu / ghi đè các chức năng cơ bản, v.v.)

Nó không sử dụng roxygen, rất tiện dụng, nhưng 7 trên 8 không tệ. ;-)

Để đáp ứng các tiêu chí của bạn:

1. Khái niệm này rất đơn giản: zoolà một lớp giống như ma trận được sắp xếp theo thứ gì đó . Không có kiến ​​thức cụ thể về tên miền cần thiết.
2. zoo dường như có một vài quy ước mã hóa bình dị, nhưng không có gì vượt trội ngăn cản việc hiểu mã.
3. zoo nhằm mục đích phù hợp với R càng tốt.

Tôi không coi mình là một nhà phát triển gói R đã thành lập nhưng gần đây đã trải qua quá trình viết và duy trì một gói cho môi trường làm việc của tôi.

Trước đây tôi đã viết / duy trì / cập nhật một tập các kịch bản mà tôi sẽ chuyển từ dự án này sang dự án thông qua source()chức năng. Kết quả cuối cùng của việc này là tôi đã kết thúc với các tập lệnh chủ yếu là dư thừa ở nhiều nơi trên các ổ đĩa mạng của chúng tôi. Không bao giờ rõ ràng nơi tập hợp các kịch bản cập nhật nhất được đặt. Tôi đã chuyển sang viết / duy trì một gói sử dụng roxygen. Nó đã đơn giản hóa cuộc sống của tôi và giúp chia sẻ công việc của tôi với các đồng nghiệp dễ dàng hơn.

Dựa trên các tiêu chí của bạn ở trên, tôi thứ hai khuyến nghị xem xét các gói mà Hadley đã viết. Đặc biệt, tôi nghĩ rằng đọc qua wiki devtools sẽ rất hữu ích. Mã của Hadley được ghi chép tốt và một số gói của anh ta sử dụng roxygen. Tôi nghĩ rằng việc viết và duy trì một tài liệu cho cả hai hàm R và tài liệu R dễ dàng hơn nhiều so với việc chúng được tách ra ở hai vị trí (tệp .R và .RD).

Các gói của Hadley cũng phục vụ một số khái niệm khá cơ bản và tương đối dễ bị lỗi (imho) nếu bạn đang tìm kiếm các gợi ý về các ý tưởng khía cạnh kỹ thuật. Tôi thấy mình đang đào mã nguồn plyr khi tôi tìm kiếm một con trỏ trên tài liệu roxygen hoặc các tác vụ cơ bản khác.

Tại sao không thực hiện một cách tiếp cận lấy mẫu ngẫu nhiên theo kinh nghiệm? Chỉ cần chọn một vài và xem công việc nào cho bạn.

Đùa sang một bên, chỉ cần nhìn vào một vài gói bạn tự sử dụng và quen thuộc. Tải xuống chúng rất dễ dàng hoặc nếu bạn thích, bạn cũng có thể xem chúng qua giao diện web tại R-Forge, RForge hoặc Github.

Bạn rất có thể sẽ kết thúc với các gói khác nhau cho các ý tưởng khác nhau. Một số có thể giúp bạn với cách họ tích hợp, nói, một họa tiết. Một số có thể giúp với mã được biên dịch. Hoặc kiểm tra đơn vị. Hoặc Roxygen. Có khoảng 2600 người trong số họ, vậy tại sao lại ám ảnh về một điều tốt nhất?

Một lời khuyên khác có thể là xem xét các gói của bạn sẽ phụ thuộc hoặc tương tác với nó, đặc biệt nếu chúng thực hiện một số mục mà Joshua Ulrich đề cập hoặc đã được viết bởi các tác giả nổi tiếng. Có thể hữu ích để tìm hiểu cách mọi thứ được thực hiện trong lĩnh vực của bạn, để đảm bảo tính tương thích. Thông thường mọi người sẽ nghĩ về một số vấn đề nhất định và đọc di chuyển giải pháp của họ là hữu ích.

tôi muốn giới thiệu gói định hình lại của hadley. bạn có thể tìm nguồn tại https://github.com/hadley/reshape