ডিএসপিএল কুকবুক

এই নথিতে দরকারী DSPL এবং ক্যানোনিকাল ধারণা "রেসিপি" এর একটি কুকবুক রয়েছে। এগুলি বিভিন্ন কাজের জন্য ধাপে ধাপে নির্দেশনা প্রদান করে যা টিউটোরিয়াল এবং বিকাশকারী গাইডে বর্ণিত মৌলিক ভাষা বৈশিষ্ট্যগুলির উপরে এবং তার বাইরে যায়৷ নীচের বিষয়বস্তু পূর্ববর্তী নথির জ্ঞান অনুমান করে, তাই আপনার "রান্না" শুরু করার আগে সেগুলি পড়তে ভুলবেন না।

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

মৌলিক রেসিপি

প্রদর্শনের নাম উল্লেখ করা হচ্ছে

গোল

একটি (মাত্রা) ধারণার প্রতিটি উদাহরণের সাথে একটি "ডিসপ্লে নাম" যুক্ত করুন। এই নামগুলি কনসেপ্ট ইনস্ট্যান্স আইডির পরিবর্তে পাবলিক ডেটা এক্সপ্লোরার UI-তে প্রদর্শিত হবে, যা ব্যবহারকারীদের বোঝার জন্য সাধারণত ছোট এবং কঠিন।

ধাপ

1. আপনার ধারণা প্রসারিত entity:entity.
2. সম্পর্কিত ধারণা সংজ্ঞা টেবিলে একটি name কলাম যোগ করুন।
3. প্রতিটি দৃষ্টান্তের নামের সাথে পরের সম্পত্তিটি পপুলেট করুন।

নোট

• আপনার ধারণা মেটাডেটাতে একটি name সম্পত্তি স্পষ্টভাবে সংজ্ঞায়িত করার প্রয়োজন নেই; আপনি যখন entity:entity প্রসারিত করেন তখন এই সংজ্ঞাটি স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত হয়।
• আপনি যথাক্রমে উদাহরণ-স্তরের বিবরণ এবং URL প্রদান করতে description এবং info_url কলাম যোগ করতে পারেন।

ধারণা শ্রেণিবিন্যাস তৈরি করা

গোল

(মাত্রা) ধারণাগুলির একটি শ্রেণিবিন্যাস তৈরি করুন। এগুলি একটি গাছ হিসাবে পাবলিক ডেটা এক্সপ্লোরার UI-তে প্রদর্শিত হবে, ব্যবহারকারীদের গ্রুপিংগুলি বুঝতে এবং তাদের মধ্যে নেভিগেট করার অনুমতি দেয়৷

ধাপ

1. একটি "পিতামাতা" ধারণা সংজ্ঞায়িত করুন (যেমন, region )।
2. একটি "শিশু" ধারণা সংজ্ঞায়িত করুন (যেমন, subregion )।
3. সন্তানের মধ্যে এমন একটি সম্পত্তি যোগ করুন যা পিতামাতার উল্লেখ করে এবং isParent বৈশিষ্ট্য অন্তর্ভুক্ত করে:

   <property concept="..." isParent="true"/>

   যেখানে বিন্দুগুলি অভিভাবক আইডি দ্বারা প্রতিস্থাপিত হয়।
4. সন্তানের জন্য সংজ্ঞা সারণীতে, অভিভাবককে উল্লেখ করে এমন একটি কলাম যোগ করুন।
5. প্রতিটি সন্তানের দৃষ্টান্তের জন্য, পিতামাতার ধারণার একটি বৈধ দৃষ্টান্ত দিয়ে পরবর্তীটিকে পপুলেট করুন।

নোট

• এর উদাহরণের জন্য টিউটোরিয়াল ডেটাসেটে country / state সম্পর্ক দেখুন।
• সন্তানের কাছ থেকে উল্লেখ করা প্রতিটি পিতামাতার আইডি অবশ্যই পিতামাতার সংজ্ঞা সারণীতে থাকতে হবে। অন্যথায়, আমদানিকারক একটি ত্রুটি তৈরি করবে।
• পিতামাতা এবং সন্তান একই ধারণা হতে পারে (অর্থাৎ, একটি স্ব-রেফারেন্সিং অনুক্রম)। এর উদাহরণের জন্য মার্কিন খুচরা বিক্রয় ডেটাসেটে business ধারণাটি দেখুন।

ধারণা উদাহরণ শ্রেণীকরণ

গোল

ধারণার দৃষ্টান্তগুলির জন্য বিভাগগুলি তৈরি করুন যা পাবলিক ডেটা এক্সপ্লোরার রঙ চয়নকারীগুলিতে বিকল্প হিসাবে প্রদর্শিত হবে৷

ধাপ

1. একটি "বিভাগ" ধারণা সংজ্ঞায়িত করুন (যেমন, income_level )।
2. একটি "শিশু" ধারণা (যেমন, country ) সংজ্ঞায়িত করুন।
3. শিশুর মধ্যে একটি সম্পত্তি যোগ করুন যা বিভাগ ধারণা উল্লেখ করে এবং একটি name উপাদান অন্তর্ভুক্ত করে:

   <property concept="..."/>
     <info>
       <name><value>"..."</value></name>
     </info>
   </property>

   যেখানে বিন্দুগুলির প্রথম সেটটি বিভাগ ধারণা আইডি দ্বারা প্রতিস্থাপিত হয় এবং দ্বিতীয় সেটটি আপনার সম্পত্তির জন্য পছন্দসই প্রদর্শন নাম দ্বারা প্রতিস্থাপিত হয় (যেমন, "আয় স্তর")।
4. সন্তানের জন্য সংজ্ঞা সারণীতে, একটি কলাম যোগ করুন যা বিভাগ ধারণাকে উল্লেখ করে।
5. প্রতিটি চাইল্ড ইন্সট্যান্সের জন্য, ক্যাটাগরি কনসেপ্টের একটি বৈধ ইন্সট্যান্স দিয়ে পরেরটিকে পপুলেট করুন।

নোট

• একটি ধারণার একাধিক বৈশিষ্ট্য থাকতে পারে যা বিভাগ হিসাবে কাজ করে; এই ক্ষেত্রে, ব্যবহারকারী রং বাছাইকারীর বিকল্প হিসাবে তাদের সব দেখতে পাবেন.
• UI-তে দৃষ্টান্তগুলিকে শ্রেণিবদ্ধভাবে সংগঠিত করার উদ্দেশ্যে একটি বিভাগও অভিভাবক হতে পারে। বিস্তারিত জানার জন্য আগের রেসিপি দেখুন.

ধারণার দৃষ্টান্তের জন্য সাজানোর ক্রম উল্লেখ করা

গোল

একটি ধারণার উদাহরণের জন্য সাজানোর ক্রম উল্লেখ করুন। পাবলিক ডেটা এক্সপ্লোরার ভিজ্যুয়ালাইজেশন পৃষ্ঠাগুলির বাম-নেভিতে দৃষ্টান্তগুলি তালিকাভুক্ত করার সময় এই অর্ডারটি ব্যবহার করা হয়।

ধাপ

1. আপনার ধারণাটি entity:entity বা এর একটি সন্তানকে প্রসারিত করুন (যেমন, geo:location )।
2. আপনার ধারণা মেটাডেটাতে একটি entity_order অ্যাট্রিবিউট যোগ করুন।
3. ALPHA বা TABLE এর একটিতে আগেরটির মান সেট করুন; পূর্ববর্তীটি দৃষ্টান্তগুলিকে তাদের প্রদর্শন নামের ক্রম অনুসারে তালিকাভুক্ত করবে, যেখানে পরেরটি দৃষ্টান্তগুলিকে ধারণা সংজ্ঞা টেবিলে প্রদর্শিত একই ক্রমে রাখবে।

নোট

• ALPHA বর্তমান ডিফল্ট, তাই আপনি যদি এই ক্রম ব্যবহার করতে চান, উপরের ধাপগুলি ঐচ্ছিক।
• একটি উদাহরণের জন্য entity:entity ডকুমেন্টেশন দেখুন।

সময় রেসিপি

ত্রৈমাসিক তথ্য

গোল

ত্রৈমাসিক ব্যবধানে নির্দিষ্ট করা ডেটা কল্পনা করুন।

ধাপ

1. আপনার স্লাইস ডেটার সমস্ত কোয়ার্টারকে মাসে রূপান্তর করুন (যেমন, ত্রৈমাসিকের প্রথম মাস)।
2. এই মাত্রাটিকে আপনার স্লাইস XML-এ time:month হিসাবে বিবেচনা করুন।

সাপ্তাহিক তথ্য

গোল

সাপ্তাহিক বিরতিতে নির্দিষ্ট করা ডেটা কল্পনা করুন।

ধাপ

1. আপনার স্লাইস ডেটার সমস্ত সপ্তাহকে দিনে রূপান্তর করুন (যেমন, সপ্তাহের প্রথম দিন)।
2. এই মাত্রাটিকে একটি time:day আপনার স্লাইস XML-এ।

জিও রেসিপি

country বা state ক্যানোনিকাল ধারণা ব্যবহার করে

গোল

ক্যানোনিকাল country বা state ধারণাগুলি ব্যবহার করুন, সমস্ত ল্যাট/লং মান ইত্যাদি আমদানি করুন, যাতে ডেটাসেটের মধ্যে এগুলিকে সংজ্ঞায়িত করার প্রয়োজন না হয়।

ধাপ

1. নিশ্চিত করুন যে আপনার স্লাইস ডেটা CSV-তে সমস্ত দেশ এবং/অথবা মার্কিন রাজ্যের রেফারেন্সগুলি আদর্শ দেশ এবং রাজ্যের সংজ্ঞা সারণী থেকে বৈধ আইডি।
2. সংশ্লিষ্ট স্লাইসে মাত্রা হিসেবে geo:country এবং/অথবা geo_us:state যোগ করুন।
3. নিশ্চিত করুন যে এইগুলির জন্য কলামের নামগুলি পূর্ববর্তী ধারণাগুলির নামের সাথে মেলে (আমদানি করা ডেটাসেটের নাম, যেমন, country সহ নয়) বা, যদি না হয়, তাহলে আপনার স্লাইস সংজ্ঞায় mapDimension বিবৃতি অন্তর্ভুক্ত করুন৷ উদাহরণ:

   <slice id="...">
     ...
     <dimension concept="geo:country"/>
     ...
     <mapDimension concept="geo:country" toColumn="my_country"/>
   </slice>

ক্যানোনিকাল দেশ বা রাজ্যগুলির শুধুমাত্র একটি উপসেট ব্যবহার করা

গোল

একটি ক্যানোনিকাল জিও ধারণার একটি উপসেট ব্যবহার করুন যাতে শুধুমাত্র এই উপসেটটি (এবং সম্পূর্ণ তালিকা নয়, যেমন বিশ্বের সমস্ত দেশ) পাবলিক ডেটা এক্সপ্লোরার UI-তে উপস্থিত হয়৷

ধাপ

1. একটি স্থানীয় ধারণা সংজ্ঞায়িত করুন যা সুপারসেট ধারণাকে প্রসারিত করে। উদাহরণ:

   <concept id="my_country_subset" extends="geo:country">
   ...
   </concept>

2. সংশ্লিষ্ট ধারণার সংজ্ঞা CSV-এ, শুধুমাত্র আপনি যে সুপারসেট ধারণা ব্যবহার করতে চান তার আইডি অন্তর্ভুক্ত করুন। উদাহরণ:

   my_country_subset
   FR  
   MX
   US

নোট

• আপনার উপসেট ধারণার প্রতিটি উদাহরণ সুপারসেট ধারণার একটি বৈধ উদাহরণ হতে হবে; আপনি নতুন উদাহরণের সাথে ধারণাটিকে "প্রসারিত" করতে পারবেন না।

আপনার নিজস্ব ভৌগলিক ধারণা সংজ্ঞায়িত করা

গোল

আপনার নিজস্ব ভৌগলিক ধারণাগুলি তৈরি করুন যা অন্বেষণযোগ্য এবং ম্যাপযোগ্য, ঠিক ক্যানোনিকাল, Google-সংজ্ঞায়িতগুলির মতো৷

ধাপ

1. একটি ধারণা তৈরি করুন যা geo:location প্রসারিত করে।
2. সংশ্লিষ্ট ধারণা সংজ্ঞা সারণীতে, কলামের name , latitude এবং longitude অন্তর্ভুক্ত করুন।
3. আপনার ধারণার প্রতিটি দৃষ্টান্তের জন্য পরবর্তী বৈশিষ্ট্যগুলি পূরণ করুন; অক্ষাংশ এবং দ্রাঘিমাংশের মানগুলি এই নিয়মের সাথে ভাসমান যে N এবং E ধনাত্মক, এবং W এবং S ঋণাত্মক।

নোট

• আপনার ধারণার সংজ্ঞায় name , latitude এবং longitude বৈশিষ্ট্যগুলি স্পষ্টভাবে অন্তর্ভুক্ত করার দরকার নেই কারণ geo:location প্রসারিত করার সময় এগুলি স্বয়ংক্রিয়ভাবে অন্তর্ভুক্ত হয়৷
• একটি উদাহরণের জন্য টিউটোরিয়াল ডেটাসেটে state সংজ্ঞা দেখুন।

মেট্রিক এবং ইউনিট রেসিপি

শতাংশ ব্যবহার করে

গোল

একটি (মেট্রিক) ধারণা সংজ্ঞায়িত করুন যা অন্য কিছুর শতাংশ।

ধাপ

1. আপনার ধারণা প্রসারিত করুন quantity:ratio ।
2. is_percentage অ্যাট্রিবিউটটিকে true এ সেট করুন।

   <attribute id="is_percentage">
     <value>true</value>
   </attribute>

3. ঐচ্ছিকভাবে, এই ধারণাটির শতাংশের উপর ভিত্তি করে percentage_of সেট করুন। উদাহরণ:

   <attribute id="percentage_of">
     <value>labor force</value>
   </attribute>

currency ইউনিট ব্যবহার করে

গোল

একটি (মেট্রিক) ধারণাকে সংজ্ঞায়িত করুন যাতে মুদ্রার একক থাকে (যেমন, মার্কিন ডলার)।

ধাপ

1. আপনার মেট্রিক প্রসারিত করুন quantity:quantity বা এর একটি সন্তান, যেমন quantity:amount ।
2. একটি unit অ্যাট্রিবিউট যোগ করুন যা unit:currency উল্লেখ করে এবং সংশ্লিষ্ট কারেন্সি সংজ্ঞা টেবিল থেকে একটি আইডিতে এর মান সেট করুন। উদাহরণ:

   <concept id="...">
     <attribute concept="unit:currency">
       <value>EUR</value>
     </attribute>
   </concept>

একটি কাস্টম ইউনিট তৈরি করা হচ্ছে

গোল

আপনার এক বা একাধিক মেট্রিকের জন্য একটি কাস্টম ইউনিট তৈরি করুন।

ধাপ

1. unit:unit প্রসারিত করে এমন একটি ধারণা তৈরি করুন।
2. সংশ্লিষ্ট সংজ্ঞা টেবিলে কলাম unit_text এবং symbol যোগ করুন। ঐচ্ছিকভাবে, আপনি যদি প্রতীকের অবস্থান সামঞ্জস্য করতে চান তবে আপনি একটি symbol_position কলাম যোগ করতে পারেন।
3. আপনার ইউনিটের প্রতিটি উদাহরণের জন্য পরবর্তী বৈশিষ্ট্যগুলির জন্য মানগুলি পূরণ করুন। "এরিয়া" ইউনিটের জন্য উদাহরণ CSV:

   my_unit,unit_text,symbol,symbol_position
   SQKM,square kilometers,km²,END
   SQML,square miles,miles²,END

4. একটি (মেট্রিক) ধারণায় আপনার সদ্য তৈরি ইউনিট ব্যবহার করতে, নিশ্চিত করুন যে পরবর্তীটি quantity:quantity বা এর একটি শিশুকে প্রসারিত করে। তারপর, একটি বৈশিষ্ট্য যোগ করুন যা আপনার ইউনিট ধারণাকে উল্লেখ করে। উদাহরণ:

   <concept id="..." extends="quantity:amount">
     ...
     <attribute concept="my_unit">
       <value>SQKM</value>
     </attribute>
     ...
   </concept>
   

নোট

• আপনার ইউনিট ধারণার শুধুমাত্র একটি উদাহরণ থাকলে, আপনি আইডি কলামটি এর সংজ্ঞা সারণী থেকে বাদ দিতে পারেন সেইসাথে এটি ব্যবহার করে এমন মেট্রিক্সের value ট্যাগগুলি।
• একটি সম্পূর্ণ উদাহরণের জন্য ক্যানোনিকাল মুদ্রা ধারণার সংজ্ঞা দেখুন।