ইগনিশন রোবোটিক্স প্রকল্প

এই পৃষ্ঠায় Google সিজন অফ ডক্সের জন্য গৃহীত প্রযুক্তিগত লেখার প্রকল্পের বিশদ বিবরণ রয়েছে৷

প্রকল্পের সারসংক্ষেপ

ওপেন সোর্স সংস্থা:

ইগনিশন রোবোটিক্স

কৌশলী লেখক:

একটি থাই লে

প্রকল্পের নাম:

ইগনিশন ফিজিক্স টিউটোরিয়াল এবং API ডকুমেন্টেশন

প্রকল্পের দৈর্ঘ্য:

স্ট্যান্ডার্ড দৈর্ঘ্য (3 মাস)

প্রকল্প বর্ণনা

প্রেরণা

ইগনিশন ফিজিক্স লাইব্রেরি ইগনিশন গাজেবো সিমুলেশনের পিছনের দিকে পোর্ট করা পদার্থবিদ্যা ইঞ্জিনগুলির নমনীয় ব্যবহার সক্ষম করে। অনেক বাহ্যিক পদার্থবিদ্যা ইঞ্জিনগুলিকে লাইব্রেরিতে অভিযোজিত করা যেতে পারে যেমন প্লাগইনগুলি তাদের ক্ষমতা এবং প্রয়োগের প্রেক্ষাপট অনুযায়ী বিভিন্ন বৈশিষ্ট্যের সেট সমন্বিত করে, যাতে গ্যাজেবো সিমুলেশনকে শক্তি দেয়। যাইহোক, লাইব্রেরির বর্তমান পর্যায় প্রদান করে না:

• কাস্টম ফিজিক্স প্লাগইন তৈরির উপর ব্যাপক টিউটোরিয়াল যা পাওয়ার সিমুলেশনে কাস্টম ফিজিক্স ইঞ্জিন ব্যবহার করে
• সুসংগত API ডকুমেন্টেশন

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

বর্ণনা

এই প্রকল্পের দুটি প্রধান লক্ষ্য রয়েছে:

• বর্তমান লাইব্রেরি API এর সাথে কাস্টম ফিজিক্স প্লাগইন ইন্টারফেসিং তৈরি করার বিষয়ে বিস্তারিত টিউটোরিয়াল তৈরি করুন।
• রক্ষণাবেক্ষণ এবং সহযোগিতার উদ্দেশ্যে বর্তমান লাইব্রেরি API ডকুমেন্টেশন উন্নত করুন।

বর্তমানে, DART এই লাইব্রেরির একমাত্র সহায়ক পদার্থবিদ্যা ইঞ্জিন। তাই, টিউটোরিয়ালগুলি DART এর চারপাশে ঘুরবে৷ এই প্রাথমিক টিউটোরিয়াল বিবেচনা করা হবে:

1. ভূমিকা : ইগনিশন ফিজিক্স লাইব্রেরির উচ্চ-স্তরের আর্কিটেকচার, সমর্থিত পদার্থবিদ্যা ইঞ্জিন এবং লক্ষ্যগুলি বর্ণনা করে।
2. ইনস্টলেশন : ব্যবহারকারীকে ঐচ্ছিকভাবে প্রয়োজনীয় পদার্থবিদ্যা ইঞ্জিন ইনস্টল করার জন্য অ্যাপ্লিকেশন প্রেক্ষাপটের উপর নির্ভর করে গাইড করে। এই টিউটোরিয়ালটি একটি নির্দিষ্ট সিমুলেশন অভিযোজিত করার জন্য প্রতিটি পদার্থবিদ্যা ইঞ্জিন প্লাগইনের জন্য উদাহরণ কনফিগারেশনও প্রদর্শন করে।
3. DART প্লাগইন ব্যবহার : গাজেবো সিমুলেশনে DART পদার্থবিদ্যা ইঞ্জিনের উদাহরণ ব্যবহার বর্ণনা করে। টিউটোরিয়ালটিতে একটি নির্দিষ্ট উদাহরণ পরিবেশে গ্যাজেবো সিমুলেশনের জন্য ব্যাক-এন্ড হিসাবে এই লাইব্রেরিটি শুরু করার জন্য এক্সিকিউশন এবং কনফিগারেশনের একটি ক্রম রয়েছে।
4. কাস্টম প্লাগইন তৈরি করুন : নতুন ব্যবহারকারী বা ডেভেলপারকে কিছু কনফিগার ফাইলের (সম্ভবত ক্লাস টেমপ্লেট) মাধ্যমে কাস্টম ফিজিক্স ইঞ্জিনের উপর ভিত্তি করে একটি কাস্টম প্লাগইন তৈরি করতে এবং ফিজিক্স ইঞ্জিন এপিআই এবং এই লাইব্রেরি এপিআই এর মধ্যে একটি ইন্টারফেস তৈরি করতে গাইড করে। টিউটোরিয়ালের শেষে কিছু বিবেক চেক নোট করা যেতে পারে।
5. একটি সিমুলেশনে একাধিক প্লাগইন ব্যবহার করা (আলোচনার প্রয়োজন) : একটি উদাহরণ সিমুলেশনের জন্য রানটাইমে একসাথে একাধিক প্লাগইন কীভাবে ব্যবহার করতে হয় তা বর্ণনা করে।

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

API ডকুমেন্টেশনের জন্য, এই লাইব্রেরির জন্য Google C++ ডকুমেন্টেশন শৈলীর সাথে মানিয়ে নেওয়া সম্ভব। উদাহরণস্বরূপ, সমস্ত ক্লাসের একটি ক্লাস স্তরের বিবরণ থাকতে হবে। তদ্ব্যতীত, সমস্ত পাবলিক ফাংশন অবশ্যই একটি বিবরণ, তাদের সমস্ত আর্গুমেন্ট, সেইসাথে সম্ভাব্য রিটার্ন মান এবং ব্যতিক্রম সহ নথিভুক্ত করা উচিত। এটি উপকারী যে সবচেয়ে গুরুত্বপূর্ণ ক্লাসগুলি (যেমন ডার্টসিম::রিট্রিভওয়ার্ল্ড, ফিচার, ইত্যাদি) একটি সহজ টপ-ডাউন পদ্ধতি হিসাবে প্রথমে নথিভুক্ত করা হবে। আরও ডকুমেন্টেশন শৈলী, গুরুত্বপূর্ণ শ্রেণী শনাক্তকরণ সম্প্রদায় বন্ধন সময় আলোচনা করা হবে.

মাইলফলক

এই বিভাগটি প্রকল্পের উল্লিখিত লক্ষ্যগুলি সম্পূর্ণ করার জন্য একটি প্রাথমিক সময়সীমার পরিকল্পনা করে। সময় পরিকল্পনা নিম্নরূপ:

• 17 আগস্ট - 13 সেপ্টেম্বর: সম্প্রদায় বন্ধন:

  1. প্রকল্পের সুযোগ এবং টিউটোরিয়াল পরিকল্পনার পাশাপাশি লেখক এবং পরামর্শদাতা উভয়ের কাছ থেকে প্রত্যাশা স্থাপনের জন্য মিটিং সেট করুন।
  2. ইগনিশন ফিজিক্স সোর্স কোডের বড় ছবি ধরুন।

• সেপ্টেম্বর 14 - অক্টোবর 31: মিটিংয়ের মাধ্যমে পরামর্শদাতা এবং লেখকের মধ্যে পুনরাবৃত্তিমূলক পরিমার্জন সহ উল্লেখিত টিউটোরিয়ালগুলি খসড়া করুন।

• নভেম্বর 1 - নভেম্বর 30: সবচেয়ে গুরুত্বপূর্ণ ক্লাসের জন্য API ডকুমেন্টেশন লিখুন এবং ডক্সিজেন ব্যবহার করে ডকুমেন্টেশন কম্পাইল করুন।

• ডিসেম্বর 1 - 5 ডিসেম্বর: প্রকল্প প্রতিবেদন লিখুন।

• GSoD 2020-এর পরে: আমি আমার কাজগুলিকে আরও উন্নত ও বজায় রাখতে ইগনিশন রোবোটিক্সের সাথে সংযুক্ত থাকতে চাই।

চূড়ান্ত নোট

ইগনিশন ফিজিক্সের প্রথম পৃষ্ঠায় বর্তমান README.md সংশোধন করা অপরিহার্য, কারণ apt-get ব্যবহার করে বাইনারি ইনস্টলেশন উবুন্টু 18.04 এ কাজ করে না। ভুল বিন্যাসের কারণে উৎস ইনস্টল বিভাগেও সংশোধন প্রয়োজন।