R Analizinizi R Markdown ile Sorunsuz Bir Şekilde Nasıl Belgeleyebilirsiniz?

R Analizinizi R Markdown Ile Sorunsuz Bir Sekilde Nasil Belgeleyebilirsiniz



Çok yönlü R Markdown formatıyla metni, yürütülebilir R kodunu ve sonuçlarını tek bir dosyaya kolayca ekleyebilirsiniz. PDF (.pdf), Word (.docx) ve HTML (.html) gibi çoklu statik ve dinamik çıktı formatları bu dosyalardan kolaylıkla dönüştürülebilir. İyi yazılmış bir R Markdown dosyasının tekrarlanabilir olma avantajı vardır. Bu aynı zamanda, veri aktarımında bir sorunla karşılaşırsanız veya araştırmaya yeni bilgiler ekleme olanağınız varsa, gerçek dosyayı değiştirmeden makaleyi yeniden oluşturabileceğiniz anlamına da gelir. RStudio zaten yerleşik R işaretleme paketine sahip olduğundan kurulumu için herhangi bir ön adıma gerek yoktur.

Test Kodu

R Markdown'a başlamadan önce sisteminizde R'nin kurulu olduğundan emin olun. Bununla birlikte RStudio'nun şu anda başlatılması gerekiyor. Öncelikle R Markdown dosyasında kullandığımız veri seti için bir script oluşturuyoruz.

Kaynak kod alanı içerisinde R’den “datasets” kütüphanesini import ediyoruz. Yerleşik veri kümeleri bu kitaplık kullanılarak getirilebilir. Böylece “AirPassengers” isimli veri seti “data” fonksiyonu kullanılarak getirilir ve “summary” fonksiyonu kullanılarak özetlenir.







Sonunda, belirli bir veri kümesinin grafik/grafik görünümünü elde etmek için bu veri kümesine arsa () işlevi uygulanır. Bu kodu çalıştırdıktan sonra konsolda görüntülenen bu veri setinin özetini alıyoruz.



kütüphane ( veri kümeleri )

veri ( 'Hava Yolcuları' )

özet ( Hava Yolcuları )

komplo ( Hava Yolcuları )



RStudio'nun sağ bölmesinde AirPassengers veri kümesinin grafiğinin göründüğünü de görebilirsiniz. Şimdi bu kodu R Markdown belgemizde kullanıyoruz.





RStudio'da R MarkDown'a Başlarken

Bir R Markdown dosyasını başlatmak için RStudio'nun sol üst penceresindeki “Dosya” menüsünü kullanmanız gerekir. Üzerine dokunun ve mevcut “Yeni Dosya” seçeneğini genişletin. “Yeni Dosya” seçeneğinde listelenen “R İşaretleme” seçeneğini bulabilirsiniz. Bir tane oluşturmak için üzerine dokunun.



RStudio ekranınızda yeni bir “Yeni R İşaretleme” penceresi görünecektir. R Markdown belgesi oluşturmak istediğimiz için sol bölmeden “Belge”yi seçmeliyiz. Artık “Başlık” alanını kullanarak belgenize isim verebilirsiniz; adını “Test” koyduk.

Ayrıca bu belgenin yazarı olarak adınızı da belirtebilirsiniz; yani “John”. Son alanda R Markdown belgesini oluşturduğunuz tarihi girmelisiniz. Bir belgeyi her güncelleştirdiğinizde belgenin tarihini oluşturmak için onay kutusunu da kullanabilirsiniz.

Şimdi dosyanızın varsayılan çıktı biçimini (html, pdf veya Word) seçmelisiniz. Bizim durumumuzda dosyanın varsayılan çıktı formatı olarak “HTML”yi seçiyoruz. Örnek bir R Markdown dosyası oluşturmaya devam etmek için “Tamam” düğmesine dokunun. Boş bir Markdown dosyası oluşturmak için “Boş Belge Oluştur” düğmesini de kullanabilirsiniz.

Düzenleme için Görsel Moda Geçin

Örnek R Markdown dosyası RStudio Kaynak alanında açılır. Artık bu örnek Markdown dosyasını ihtiyaçlarınıza göre düzenleyebilirsiniz. Bu Markdown örnek dosyası üç bölüme ayrılmıştır. Markdown dosyasının “—” ile başlayıp biten kısmına “Başlık” denir. Örnek bir işaretleme dosyası oluşturmaya başladığınızda sağladığınız bilgileri (ör. başlık, yazar, tarih ve çıktı biçimi) içerir.

Metin satırlarını içeren “## R Markdown” kısmı bu markdown dosyasının “metin” bloğudur. Ayrıca güncelleyebilir ve metninizi üzerine yerleştirebilirsiniz. “## R Markdown” da güncellenebilecek bir başlıktır. Üç ““`” sembolüyle başlayan bir sonraki bölüm, kod parçacıklarının eklenmesine özel olan “Kod Parçası” bölümünü ifade eder. Kodlama kısmına, kodlar aracılığıyla grafik oluşturmaya özel “grafikler” kısmı da eşlik edebilir.

Açılan RStudio penceresinin görev çubuğundan “Visual” butonunu kullanarak R Markdown dosyasının “Visual” moduna geçiyoruz. Yeni açılan pencere size Görsel modda hareket etme konusunda bazı talimatlar sağlar. Görsel modu açmak için “Görsel Modu Kullan” düğmesine dokunun.

Örnek Dosyayı Düzenleyin

Artık R Markdown örnek dosyası için düzenleme “Görsel” modu başlatıldı. Görev çubuğunda sağlanan menüleri kullanarak dosyanın tamamını biçimlendirebilir, ekleyebilir ve düzenleyebilirsiniz. Mesela Header kısmını güncellemedik ama “Metin” ve “Plots” bloklarının Header başlıklarını değiştirdik. Örnek metni yeni bir metinle değiştirin ve kod alanına yeni bir kod girin. Bu dosyanın “Plot” bloğunu da yana doğru güncelledik.

Dosya 'yı kaydet

Şimdi bir belge oluşturmak için RStudio'nun görev çubuğunda bulunan 'Ör' düğmesini kullanın.

Şimdi RStudio size kaydedeceğiniz yeni Markdown dosyasının konumunu ve adını soracaktır. R Markdown dosyasının türü varsayılan olarak “.Rmd”dir. Aşağıdaki görüntüye göre “test” adını veriyoruz ve “Save” butonu ile “D” sürücüsüne kaydediyoruz:

Yeni oluşturulan R Markdown dosyanızı kaydettikten sonra RStudio, belgeyi görüntülemek için küçük bir işleme dahil olabilir. Bundan önce aşağıdaki pencereyi açarak sizden yeni bir oturum başlatmanızı isteyebilir. Devam etmek için “Yeni Oturum Başlat”a dokunun:

Markdown Belgesini İnceleyin

Bir süre sonra yeni oluşturulan R Markdown belgesinin RStudio üzerinden ayrı bir pencerede açılmasıyla birlikte RStudio yeni oturumuna başlıyor. Dosya, dosyanın başlığının 'Test' olduğu ve ardından yazarın adı ve oluşturulma tarihi ile birlikte 'Başlık' bloğunu içerir. Kod ve çizim bloğu, 'Test' kodu çıkışında görüntülenen çıktının yüzde 100 aynısını gösterir.

Çözüm

Bu kılavuz, R Markdown aracılığıyla bir belge oluşturmak için R dilinin kullanılmasına ilişkin en iyi gösterimi sağlar. Belgenin kurulumundan başlayarak, yeni oluşturulan R Markdown dosyasının nasıl düzenleneceğini, kaydedileceğini ve açılacağını ve başlık bloğuna, metin bloğuna, kod yığın bloğuna ve çizim bloğuna nasıl bakılacağını açıkladık.