DSPL Yemek Kitabı

Bu dokümanda, yararlı DSPL rehberi ve standart "tarifler" kavramının yer aldığı bir tarif defteri bulunmaktadır. Bu kılavuzlar, Eğitim ve Geliştirici Kılavuzu'nda açıklanan temel dil özelliklerinin ötesine geçen çeşitli görevler için adım adım yol tarifi sağlar. Aşağıdaki içerik, önceki dokümanlar hakkında bilgi sahibi olduğunu varsayar. Bu nedenle, "yemek pişirmeye" başlamadan önce bu belgeleri mutlaka okuyun.

Her yemek tarifi bir hedefle, takip edilecek adımların belirli bir listesiyle başlar. Çoğunda ayrıca DSPL snippet'leri veya harici örneklere bağlantılar bulunur. Bir yemek tarifi hakkında geri bildiriminiz varsa veya başkalarını önermek istiyorsanız lütfen DSPL Forumu'nda bir mesaj yayınlayın.

Temel Yemek Tarifleri

Görünen adları belirtme

Hedef

"Boyut" kavramının her örneğiyle bir "görünen adı" ilişkilendirin. Bu adlar, genellikle daha kısa ve kullanıcıların anlaması daha zor olan kavram örneği kimlikleri yerine Public Data Explorer kullanıcı arayüzünde görünür.

Adımlar

1. Konseptiniz entity:entity. uzatılsın
2. İlişkili kavram tablosu tablosuna name sütunu ekleyin.
3. İkinci özelliği her örneğin adıyla doldurun.

Notlar

• Kavram meta verilerinizde açık olarak bir name özelliği tanımlamanız gerekmez. entity:entity kapsamını genişlettiğinizde bu tanım otomatik olarak dahil edilir.
• İsterseniz örnek düzeyinde açıklamalar ve URL'ler sağlamak için sırasıyla description ve info_url sütunlarını da ekleyebilirsiniz.

Konsept hiyerarşileri oluşturma

Hedef

(Boyut) kavramların hiyerarşisini oluşturun. Bunlar, Public Data Explorer kullanıcı arayüzünde ağaç olarak gösterilerek kullanıcıların gruplamaları anlamalarına ve bunlar arasında gezinmelerine olanak tanır.

Adımlar

1. "Üst" bir kavram tanımlayın (ör. region) bilgileri gösterilir.
2. "Alt" kavramı tanımlayın (ör. subregion) bilgileri gösterilir.
3. Alt öğede üst öğeye başvuruda bulunan ve isParent özelliğini içeren bir özellik ekleyin:

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

   Burada noktalar, üst kimlikle değiştirilir.
4. Alt öğenin tanım tablosunda, üst öğeye referans veren bir sütun ekleyin.
5. Her alt örnek için ikinci örneği, üst kavramın geçerli bir örneğiyle doldurun.

Notlar

• Bunun bir örneği için eğitim veri kümesindeki country / state ilişkisini inceleyin.
• Alt yayıncıdan başvurulan her üst kimlik, üst öğenin tanım tablosunda olmalıdır. Aksi takdirde, içe aktarma işlemi bir hata üretir.
• Üst ve alt öğe aynı kavram olabilir (ör. kendine referans veren bir hiyerarşi). Bunun bir örneği için ABD Perakende Satış Veri Kümesi'ndeki business kavramını inceleyin.

Konsept örneklerini kategorilere ayırma

Hedef

Public Data Explorer renk seçicilerde seçenek olarak görünecek kavram örnekleri için kategoriler oluşturun.

Adımlar

1. "Kategori" kavramı tanımlayın (ör. income_level) bilgileri gösterilir.
2. "Alt" kavramı tanımlayın (ör. country) bilgileri gösterilir.
3. Alt kategoriye, kategori kavramına referans veren ve name öğesi içeren bir mülk ekleyin.Burada

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

   ilk nokta grubu, kategori kavramı kimliğiyle ve ikinci grup, mülkünüz için istediğiniz görünen adla değiştirilir (ör. "Gelir Düzeyi").
4. Alt öğenin tanım tablosunda, kategori kavramına referans veren bir sütun ekleyin.
5. Her alt örnek için ikinci örneği, kategori kavramının geçerli bir örneğiyle doldurun.

Notlar

• Bir kavram, kategori işlevi gören birden fazla özelliğe sahip olabilir. Bu durumda kullanıcı, bunların tümünü renk seçicilerde seçenek olarak görür.
• Kategorilerden biri, örnekleri kullanıcı arayüzünde hiyerarşik olarak düzenlemek amacıyla da üst öğe olabilir. Ayrıntılar için önceki tarife bakın.

Kavram örnekleri için sıralama ölçütünü belirleme

Hedef

Bir kavramın örneklerinin sıralama sırasını belirtin. Bu sıra, Public Data Explorer görselleştirme sayfalarının sol gezinme bölmesindeki örnekler listelenirken kullanılır.

Adımlar

1. Konseptinizin entity:entity veya alt öğelerinden birini (ör. geo:location) bilgileri gösterilir.
2. Kavram meta verilerinize bir entity_order özelliği ekleyin.
3. Önceki değerin değerini ALPHA veya TABLE değerlerinden birine ayarlayın. İkincisi ise örneklerin görünen adlarına göre sıralanmasına neden olur. İkincisi ise örnekleri kavram tanımı tablosunda göründükleri sırayla saklar.

Notlar

• ALPHA, şu anda varsayılan seçenektir. Bu sıralamayı kullanmak istiyorsanız yukarıdaki adımlar isteğe bağlıdır.
• Örnek için entity:entity dokümanlarına bakın.

Zaman Tarifleri

Üç aylık veriler

Hedef

Üç aylık aralıklarla belirtilen verileri görselleştirin.

Adımlar

1. Dilim verilerinizdeki tüm çeyrekleri aylara dönüştürün (ör. çeyreğin ilk ayı).
2. Bu boyutu, dilim XML'nizde time:month olarak değerlendirin.

Haftalık veriler

Hedef

Haftalık aralıklarla belirtilen verileri görselleştirin.

Adımlar

1. Dilim verilerinizdeki tüm haftaları günlere (ör. haftanın ilk gününe) dönüştürün.
2. Bu boyutu, dilim XML'nizde time:day olarak değerlendirin.

Coğrafi Tarifler

country veya state standart kavramları kullanma

Hedef

Standart country veya state kavramlarını kullanarak tüm enlem/boylam değerlerini içe aktarın. Böylece bunların veri kümesinde tanımlanması gerekmez.

Adımlar

1. Dilim veri CSV'lerinizdeki tüm ülke ve/veya ABD eyaleti referanslarının standart ülke ve eyalet tanım tablolarından geçerli kimlikler olduğundan emin olun.
2. İlgili dilimlerde boyut olarak geo:country ve/veya geo_us:state ekleyin.
3. Bunlara ait sütun adlarının önceki kavramların adlarıyla eşleştiğinden emin olun (içe aktarılan veri kümesi adı dahil değildir). country) kullanın. Aksi takdirde, dilim tanımınıza mapDimension ifadelerini ekleyin. Örnek:

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

Standart ülkelerin veya eyaletlerin yalnızca bir alt kümesini kullanma

Hedef

Herkese Açık Veri Gezgini kullanıcı arayüzünde, yalnızca bu alt grubun (ör. dünyanın tüm ülkeleri) gösterilmemesi için standart coğrafi konseptin bir alt kümesini kullanın.

Adımlar

1. Üst küme kavramını genişleten bir yerel kavram tanımlayın. Örnek:

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

2. İlişkili kavram tanımı CSV'sine yalnızca kullanmak istediğiniz üst küme kavramının kimliklerini ekleyin. Örnek:

   my_country_subset
   FR  
   MX
   US
   

Notlar

• Alt grup kavramınızın her örneği, üst küme kavramının geçerli bir örneği olmalıdır; kavramı yeni örneklerle "genişletemezsiniz".

Kendi coğrafi kavramlarınızı tanımlama

Hedef

Standart, Google tarafından tanımlanmış kavramlar gibi kendi keşfedilebilir ve eşlenebilir coğrafi kavramlarınızı oluşturun.

Adımlar

1. geo:location tarihini kapsayan bir kavram oluşturun.
2. İlişkili kavram tablosunda name, latitude ve longitude sütunlarını ekleyin.
3. Konseptinizin her örneği için son özellikleri doldurun. Enlem ve boylam değerleri, N ve E'nin pozitif, W ve S'nin negatif olduğu prensibiyle yüzer.

Notlar

• name, latitude ve longitude özelliklerini, geo:location
• Örnek için eğitim veri kümesindeki state tanımını inceleyin.

Metrik ve Birim Tarifleri

Yüzde değerleri kullanılıyor

Hedef

Başka bir şeyin yüzdesi olan bir (metrik) kavram tanımlayın.

Adımlar

1. Konseptiniz quantity:ratio uzatılsın.
2. is_percentage özelliğini true olarak ayarlayın.

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

3. İsteğe bağlı olarak percentage_of özelliğini bu kavramın yüzdesine göre ayarlayabilirsiniz. Örnek:

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

currency birim kullanılıyor

Hedef

Para birimi birimleri (ör. ABD Doları).

Adımlar

1. Metriğinizin quantity:quantity veya alt öğelerinden birini (ör. quantity:amount) genişletmesini sağlayın.
2. unit:currency özelliğine referans veren bir unit özelliği ekleyin ve bunun değerini, ilişkili para birimi tanımı tablosundan bir kimliğe ayarlayın. Örnek:

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

Özel birim oluşturma

Hedef

Metriklerinizden bir veya daha fazlası için özel birim oluşturun.

Adımlar

1. unit:unit tarihini kapsayan bir kavram oluşturun.
2. İlişkili tanım tablosuna unit_text ve symbol sütunlarını ekleyin. İsteğe bağlı olarak, simgenin konumunu ayarlamak isterseniz bir symbol_position sütunu da ekleyebilirsiniz.
3. Biriminizin her bir örneğinin ikinci özellikleriyle ilgili değerleri girin. "Alan" birimleri için örnek CSV:

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

4. Yeni oluşturduğunuz birimi (metrik) konseptinde kullanmak için, yeni biriminizin quantity:quantity öğesini veya alt öğelerinden birini kapsadığından emin olun. Ardından, birim kavramınıza referans veren bir özellik ekleyin. Örnek:

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

Notlar

• Birim konseptinizde yalnızca tek bir örnek varsa kimlik sütununu hem tanım tablosundan hem de bu metriği kullanan metriklerdeki value etiketlerini atlayabilirsiniz.
• Tam bir örnek için standart para birimi kavramının tanımına bakın.