আমি একটি পুনরুত্পাদনযোগ্য কাগজ লিখছি, এবং কাগজটি একটি পাইথন স্ক্রিপ্ট দ্বারা উত্পাদিত গুণগত ফলাফল রয়েছে (অনুরূপ একটি ম্যাটল্যাব স্ক্রিপ্ট প্রায় অভিন্ন ফলাফল উত্পন্ন করে)। আমি অনুভব করি যে পাঠকরা কোডটিতে গণনার সাথে কাগজের হিসাব মেলাতে পারলে পাঠকরা তাদের পক্ষে বুঝতে সহজ হবে। কাজটি একটি বিমূর্ত আনুষ্ঠানিকতার প্রস্তাব দেয় এবং কাগজের উদাহরণগুলি পাঠকদের জন্য এই আনুষ্ঠানিকতাটিকে আরও কংক্রিট করার কথা বলেছে (যাদের মধ্যে অনেকে প্রকৌশলী হবে); কোডটি সম্ভবত গণনাগুলি কীভাবে সম্পাদন করা যায় তার সর্বাধিক বিস্তারিত রেকর্ড হবে এবং এটি পরিষ্কার করা আমাদের পর্যালোচনা প্রক্রিয়ার সময় সহায়তা করতে পারে help
কোড এবং গণনার ফলাফলের (চিত্র, সমীকরণ) আরও সুস্পষ্টভাবে কীভাবে যুক্ত করা যায় সে সম্পর্কে কারও কি কোনও পরামর্শ রয়েছে?
উদাহরণস্বরূপ, আমি ভাবছিলাম যে যখন কাগজে বিভিন্ন পদক্ষেপ প্রয়োগের কোডের লাইনগুলির কথা আসে তখন আমি সমীকরণের নম্বরগুলি উদ্ধৃত করতে পারি (আমি কোড এবং লটেক্সের মধ্যে রেফারেন্সটি পার করতে পারলে আশ্চর্য হবে তবে তাদের হাতে লেবেলিং ঠিক আছে) , এবং আমি বিভিন্ন উদাহরণ এবং পরিসংখ্যানের সাথে সম্পর্কিত ফাংশন লিখতে পারি, যেমন
def example_1():
# Insert code corresponding to first example
pass
def figure_1():
# Insert code that generates Figure 1
pass
কোডটি যদি বড় হয়, এবং প্রকৌশলটিতে ব্যবহৃত বিভিন্ন গাণিতিক পদ্ধতিগুলির গোছা কীভাবে আসলে একই রকম ছিল তা আমি ব্যাখ্যা করার চেষ্টা করছিলাম না তবে আমি সম্ভবত কোডটি পরিষ্কার করে এতটা বিরক্ত করব না, তবে তার বিমূর্ত প্রকৃতিটি দেওয়া হয়েছিল কাগজ এবং ছোট কোড বেস, মনে হচ্ছে এই অনুশীলনের মান থাকতে পারে।