کتاب آشپزی DSPL

این سند حاوی کتاب آشپزی مفید DSPL و مفهوم متعارف "دستورات" است. اینها دستورالعمل‌های گام به گام را برای انواع کارها ارائه می‌کنند که فراتر از ویژگی‌های زبان اصلی توضیح داده‌شده در راهنمای آموزشی و برنامه‌نویس هستند. محتوای زیر مستلزم آگاهی از اسناد قبلی است، بنابراین قبل از شروع "آشپزی" حتما آنها را مطالعه کنید.

هر دستور غذا با یک هدف شروع می شود و پس از آن یک لیست مشخص از مراحل را دنبال می کند. بسیاری نیز شامل قطعه‌های DSPL یا پیوندهایی به نمونه‌های خارجی هستند. اگر بازخوردی در مورد یک دستور غذا دارید یا می‌خواهید به دیگران پیشنهاد دهید، لطفاً یک پیام در انجمن DSPL ارسال کنید.

دستور العمل های اساسی

تعیین نام های نمایشی

هدف

یک "نام نمایش" را با هر نمونه از یک مفهوم (بعد) مرتبط کنید. این نام‌ها به‌جای شناسه‌های نمونه مفهومی، که معمولاً کوتاه‌تر و درک آن‌ها برای کاربران سخت‌تر است، در رابط کاربری Public Data Explorer نشان داده می‌شوند.

مراحل

1. مفهوم خود را گسترش دهید entity:entity.
2. یک ستون name به جدول تعریف مفهوم مرتبط اضافه کنید.
3. ویژگی دوم را با نام هر نمونه پر کنید.

یادداشت

• نیازی به تعریف صریح ویژگی name در ابرداده مفهومی شما نیست. وقتی entity:entity را بسط می‌دهید، این تعریف به‌طور خودکار گنجانده می‌شود.
• همچنین می‌توانید ستون‌های description و info_url را به ترتیب برای ارائه توضیحات و URLهای سطح نمونه اضافه کنید.

ایجاد سلسله مراتب مفهومی

هدف

سلسله مراتبی از مفاهیم (بعد) ایجاد کنید. اینها در رابط کاربری Public Data Explorer به صورت درختی نشان داده می شوند و به کاربران امکان می دهند گروه بندی ها را درک کنند و بین آنها حرکت کنند.

مراحل

1. یک مفهوم "والد" را تعریف کنید (مثلاً region ).
2. یک مفهوم "کودک" را تعریف کنید (به عنوان مثال، subregion ).
3. یک ویژگی در فرزند اضافه کنید که به والد ارجاع می دهد و شامل ویژگی isParent است:

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

   که در آن نقطه ها با شناسه والد جایگزین می شوند.
4. در جدول تعریف فرزند، ستونی اضافه کنید که به والد اشاره دارد.
5. برای هر نمونه فرزند، مورد دوم را با یک نمونه معتبر از مفهوم والد پر کنید.

یادداشت

• برای نمونه ای از این، رابطه country / state را در مجموعه داده های آموزشی ببینید.
• هر شناسه والد ارجاع شده از فرزند باید در جدول تعریف والدین باشد. در غیر این صورت، واردکننده خطا ایجاد می کند.
• والد و فرزند می توانند یک مفهوم باشند (یعنی یک سلسله مراتب خودارجاعی). برای مثال، مفهوم business را در مجموعه داده های خرده فروشی ایالات متحده ببینید.

دسته بندی مصادیق مفهومی

هدف

دسته‌هایی را برای نمونه‌های مفهومی ایجاد کنید که به‌عنوان گزینه‌هایی در انتخابگرهای رنگی Public Data Explorer نشان داده می‌شوند.

مراحل

1. مفهوم «دسته» را تعریف کنید (مثلاً income_level ).
2. مفهوم "کودک" را تعریف کنید (مثلا country ).
3. یک ویژگی در فرزند اضافه کنید که به مفهوم دسته اشاره می کند و شامل یک عنصر name است:

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

   که در آن اولین مجموعه نقطه با شناسه مفهوم دسته و مجموعه دوم با نام نمایشی دلخواه برای ویژگی شما جایگزین می شود (به عنوان مثال، "سطح درآمد").
4. در جدول تعریف کودک، ستونی اضافه کنید که به مفهوم دسته اشاره دارد.
5. برای هر نمونه فرزند، مورد دوم را با یک نمونه معتبر از مفهوم دسته پر کنید.

یادداشت

• یک مفهوم می تواند چندین ویژگی داشته باشد که به عنوان دسته بندی عمل می کنند. در این حالت کاربر همه آنها را به عنوان گزینه در انتخابگرهای رنگ مشاهده می کند.
• یکی از دسته‌ها می‌تواند به منظور سازمان‌دهی نمونه‌ها به صورت سلسله مراتبی در رابط کاربری، والد باشد. برای جزئیات به دستور قبلی مراجعه کنید.

تعیین ترتیب مرتب سازی برای نمونه های مفهومی

هدف

ترتیب مرتب سازی را برای نمونه های یک مفهوم مشخص کنید. این ترتیب هنگام فهرست کردن نمونه‌ها در نوار سمت چپ صفحات تجسم Public Data Explorer استفاده می‌شود.

مراحل

1. مفهوم خود را گسترش دهید entity:entity یا یکی از فرزندان آن (به عنوان مثال، geo:location ).
2. یک ویژگی entity_order به ابرداده مفهومی خود اضافه کنید.
3. مقدار قبلی را به یکی از ALPHA یا TABLE تنظیم کنید. اولی باعث می‌شود که نمونه‌ها به ترتیب نام‌های نمایشی‌شان فهرست شوند، در حالی که دومی نمونه‌ها را به همان ترتیبی که در جدول تعریف مفهوم ظاهر می‌شوند حفظ می‌کند.

یادداشت

• ALPHA پیش‌فرض فعلی است، بنابراین اگر می‌خواهید از این سفارش استفاده کنید، مراحل بالا اختیاری هستند.
• برای مثال به مستندات entity:entity مراجعه کنید.

دستور العمل های زمان

داده های فصلی

هدف

داده هایی را که در فواصل سه ماهه مشخص شده اند تجسم کنید.

مراحل

1. تمام سه ماهه های داده های برش خود را به ماه (به عنوان مثال، ماه اول سه ماهه) تبدیل کنید.
2. این بعد را به عنوان یک time:month در XML برش خود در نظر بگیرید.

داده های هفتگی

هدف

داده هایی را که در فواصل زمانی هفتگی مشخص شده اند تجسم کنید.

مراحل

1. همه هفته های داده های برش خود را به روز (مثلاً روز اول هفته) تبدیل کنید.
2. این بعد را به عنوان یک time:day در XML برش خود در نظر بگیرید.

دستور العمل های جغرافیایی

استفاده از مفاهیم متعارف country یا state

هدف

از مفاهیم country یا state متعارف استفاده کنید، همه مقادیر lat/long و غیره را وارد کنید تا نیازی به تعریف آنها در مجموعه داده نباشد.

مراحل

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>
   

تنها با استفاده از زیرمجموعه ای از کشورها یا ایالت های متعارف

هدف

از زیرمجموعه ای از مفهوم جغرافیایی متعارف استفاده کنید تا فقط این زیرمجموعه (و نه کل لیست، به عنوان مثال همه کشورهای جهان) در رابط کاربری Public Data Explorer ظاهر شود.

مراحل

1. یک مفهوم محلی را تعریف کنید که مفهوم سوپرست را گسترش دهد. مثال:

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

2. در تعریف مفهومی مرتبط با CSV، فقط شناسه‌های مفهوم superset را که می‌خواهید استفاده کنید، درج کنید. مثال:

   my_country_subset
   FR  
   MX
   US
   

یادداشت

• هر نمونه از مفهوم زیر مجموعه شما باید یک نمونه معتبر از مفهوم superset باشد. شما نمی توانید مفهوم را با نمونه های جدید "بسط" کنید.

تعریف مفاهیم جغرافیایی خودتان

هدف

مفاهیم جغرافیایی خود را ایجاد کنید که قابل کاوش و نقشه برداری هستند، درست مانند مفاهیم متعارف و تعریف شده توسط گوگل.

مراحل

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. به صورت اختیاری، ویژگی درصد_of را بر اساس 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>
   

یادداشت

• اگر مفهوم واحد شما فقط یک نمونه دارد، می‌توانید ستون ID را از جدول تعریف آن و همچنین برچسب‌های value در معیارهایی که از آن استفاده می‌کنند حذف کنید.
• برای مثال کامل به تعریف مفهوم ارز متعارف مراجعه کنید.