আর সহায়তা পৃষ্ঠাগুলিতে "চালানো নয়" এর অর্থ কী?

Question

কখনও কখনও একটি আর সহায়ক পৃষ্ঠায় মন্তব্যগুলিতে "চালানো হয় না" শব্দটি উপস্থিত হয়। "()" এর জন্য সহায়তা পৃষ্ঠা থেকে এটি দেখুন:

Examples
require(stats); require(graphics)
#examples from glm:
**## Not run:** 
library(MASS)
with(anorexia, {
    anorex.1 <- glm(Postwt ~ Prewt + Treat + offset(Prewt),
                    family = gaussian)
    summary(anorex.1)
})
## End(**Not run**)

"রান নয়" উদাহরণ কোডটিতে কী বোঝায়?

Comments

কেবল একটি সম্পর্কিত টিপ আপনি "উদাহরণ (গ্ল্যাম)" জারি করে উদাহরণ কোডটি চালাতে পারেন।

— এডুয়ার্ডো লিওনি

এটি একটি ভাল টিপ। এবং আমি বাজি দিয়েছি যে বিশাল সংখ্যক আর ব্যবহারকারী এটি সম্পর্কে অবগত নয়।

— ড্যান গোল্ডস্টেইন

তবে দ্রষ্টব্য উদাহরণ (fn) এখনও কোডটি মোড়ানো উদাহরণ হিসাবে দেখবে নাdontRun

— টাইম

আপনি যদি run.dontrunপ্যারামিটারটি সেট করেন তবেTRUE

— মুডি_ মুডস্কিপার

Answer 1

"চালনা করেন না" কোডটি আবদ্ধ করে যা কার্যকর করা উচিত নয় example ফাংশনে (যেমন সময় গ্রহণকারী কোড অংশ, ব্যবহারকারী-মিথস্ক্রিয়া, ...)।

যেমন দেখুন ?example :

ম্যানুয়াল রাইটিং আর এক্সটেনশানগুলিতে বিশদ হিসাবে , সহায়তা পৃষ্ঠার লেখক দুটি ব্যতিক্রম নিয়মের উদাহরণগুলির অংশগুলি চিহ্নিত করতে পারেন

• 'দন্টরুন' কোডটি আবদ্ধ করে যা চালানো উচিত নয়।

• 'ডান্টশো' সহায়তা পৃষ্ঠাগুলিতে অদৃশ্য এমন কোডটি আবদ্ধ করে, তবে প্যাকেজ চেকিং সরঞ্জাম এবং 'উদাহরণ ()' ফাংশন দ্বারা চালিত হবে। এটি আগে 'টেস্টোনলি' ছিল এবং এখনও সেই রূপটি গৃহীত।

Comments

... আমি কিভাবে এই ফাংশন সম্পর্কে জানতাম না?

— ম্যাট পার্কার

এটি কেবলমাত্র সময় গ্রহণকারী কোড নয় যা সাধারণত একটি \ দন্তরান {of এর ভিতরে রাখা হয়} কোড যে ব্যবহারকারীর ইনপুট চাহিদা প্রয়োজন ভিতরে পাশাপাশি dontrun করা হবে বা অন্য এটা পাস করা হবে নাR CMD check

— Dason

অথবা: এমন কোড যা কোনও প্যাকেজের উপর নির্ভর করে যা ব্যবহারকারীর মেশিনে ইনস্টল করা নাও হতে পারে। Ont dontrun {}

— জেসন

Answer 2

ইন "লিখন আর এক্সটেনশানগুলি" ম্যানুয়াল, \ উদাহরণ সম্পর্কে বিভাগে {...} বলা হয় যে

আপনি পাঠ্যের জন্য shown dontrun {use ব্যবহার করতে পারেন যা কেবল প্রদর্শিত হবে, তবে চালানো হবে না এবং পরীক্ষার জন্য অতিরিক্ত কমান্ডের জন্য commands dontshow {} ব্যবহারকারীর কাছে প্রদর্শিত হবে না, তবে উদাহরণ দিয়ে চালানো হবে ()

আপনি যখন একটি প্যাকেজ তৈরি করেন তখন code dontrun}} বন্ধ করার সমস্ত কোড হিসাবে সহায়তায় দৃশ্যমান

## Not run:
...
## End(**Not run**)

সম্পাদনা: এই উত্তরটি আগে ছিল।

Answer 3

এটি \donttest{}@ হ্যাডলির আর প্যাকেজগুলি থেকে যুক্ত করা হয় এবং ভারব্যাটিম নেওয়া হয় ।

তবে উদাহরণের উদ্দেশ্যে, কোডটি অন্তর্ভুক্ত করা প্রায়শই দরকারী যা একটি ত্রুটির কারণ ঘটায়। \dontrun{}আপনাকে কখনই ব্যবহৃত হয় না এমন উদাহরণে কোড অন্তর্ভুক্ত করতে দেয়। আরও দুটি বিশেষ কমান্ড রয়েছে।\dontshow{}চালানো হয় তবে সহায়তা পৃষ্ঠায় প্রদর্শিত হয় না: এটি অনানুষ্ঠানিক পরীক্ষার জন্য কার্যকর হতে পারে। \donttest{}উদাহরণে চালানো হয় তবে আর সিএমডি চেকটিতে স্বয়ংক্রিয়ভাবে চালিত হয় না। এটি কার্যকর যদি আপনার কাছে এমন উদাহরণ থাকে যা চালাতে দীর্ঘ সময় নেয়। বিকল্পগুলি নীচে সংক্ষিপ্ত করা হয়।

Command      example    help       R CMD check
\dontrun{}                 x
\dontshow{}       x                          x
\donttest{}       x        x

Comments

দ্রষ্টব্য যে এখন পরীক্ষা করা হচ্ছে

— টাইলার রিঙ্কার

প্যাকেজ জমা দেওয়ার জন্য, আপনার কাছে কি কোনও অতিরিক্ত মন্তব্য থাকতে হবে। কোড ব্লক বাদ দেওয়ার ন্যায্যতা উল্লেখ করে? আমার কোনও প্যাকেজটি একটি ont donttest {} উদাহরণের কারণে ব্যর্থ হয়েছে কিনা তা যাচাই করেছিলাম এবং ভাবছি যে এটি changing dontrun {to এ পরিবর্তন করার মতো কোনও সাধারণ} ফাংশনটি একটি এফটিপি থেকে ডেটা ডাউনলোড করার জন্য এবং সিআরএএন মন্তব্যটি হ'ল: "এটি .dd ফাইলগুলিতে মন্তব্য করা হয়নি that উল্লেখ্য যে উদাহরণটি () এই বিভাগগুলি পরিচালনা করবে"।

— জেফরি ইভান্স

হ্যাঁ এটি সহজ হতে হবে।

— টাইলার রিঙ্কার

@TylerRinker আপনার অর্থ ফাংশনটি কাজ হিসাবে যাচাই করা হয়েছে, বা @ ডনটেস্ট {in সহ কোডটি এখন সিআরএন দ্বারা চালানো হয় চেকগুলি করার সময়?

— টিম

হ্যাঁ হ্যাডলির বইয়ের উদ্ধৃতি: "উদাহরণের উদ্দেশ্যে, কোডটি একটি ত্রুটির কারণ হিসাবে অন্তর্ভুক্ত করা প্রায়শই কার্যকর। Ont dontrun {you আপনাকে সেই উদাহরণটিতে কোড অন্তর্ভুক্ত করতে দেয় যা চালিত হয় না ((আপনি ব্যবহৃত হত অনুরূপ উদ্দেশ্যে \ donttest {use ব্যবহার করতে সক্ষম, তবে এটি আর সুপারিশ করা হয় না কারণ এটি আসলে পরীক্ষা করা হয়)) "

— টাইলার রিঙ্কার

Answer 4

আবশ্যক-টু-রিড তৈরি করতে হবে প্যাকেজগুলি তৈরি করা: 5 এর অধ্যায় 5.4 (আর ডকুমেন্টেশন ফাইলগুলি) থেকে সি & পি : ফ্রিডরিচ লিশের একটি টিউটোরিয়াল :

উদাহরণ বিভাগে এক্সিকিউটেবল আর কোড থাকা উচিত এবং কোডটি স্বয়ংক্রিয়ভাবে চালানো কোনও প্যাকেজ যাচাইয়ের অংশ। উদাহরণগুলির জন্য দুটি বিশেষ মার্কআপ কমান্ড রয়েছে:

দন্টরুন : \ dontrun inside inside এর ভিতরে থাকা সমস্ত কিছুই পরীক্ষা বা উদাহরণ () দ্বারা কার্যকর করা হয় না। এটি কার্যকর, উদাহরণস্বরূপ, ইন্টারেক্টিভ ফাংশনগুলির জন্য, ইন্টারনেট অ্যাক্সেস করার জন্য বিভিন্ন ক্রিয়াকলাপগুলির জন্য ..

Answer 5

ক্যানোনিকাল উদাহরণটি এখানে সহায়তা পৃষ্ঠায় থাকতে পারে rm:

## Not run: 
## remove (almost) everything in the working environment.
## You will get no warning, so don't do this unless you are really sure.
rm(list = ls())

## End(Not run)

এটি যদি চালিত হয় তবে অবশ্যই এটির অনাকাঙ্খিত প্রভাব রয়েছে।