13.2. Function များ စာရင်း (List of functions)

QGIS တွင် ရရှိနိုင်သော function များ၊ operator များနှင့် variable (ကိန်းရှင်) များကို အောက်တွင် အမျိုးအစားအလိုက် အုပ်စုခွဲထားပါသည်။

13.2.1. ‌ဒေတာအနှစ်ချုပ် Function များ (Aggregates Functions)

ဤအုပ်စုတွင် layer များနှင့် field များပေါ်ရှိ တန်ဖိုးများကို စုစည်းပေးသည့် function များ ပါဝင်ပါသည်။

13.2.1.1. aggregate

အခြား layer မှ feature များကို အသုံးပြုပြီး တွက်ချက်ထားသည့် စုပေါင်းထားသောတန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	aggregate(layer, aggregate, expression, [filter], [concatenator=’’], [order_by]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - Layer အမည် သို့မဟုတ် layer ID ကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု aggregate - တွက်ချက်မှုများပြုလုပ်ရန် aggregate နှင့်သက်ဆိုင်သည့် string တစ်ခု။ ရရှိနိုင်သည့် နည်းလမ်းများမှာ- count (အရေအတွက်) count_distinct (ထင်ရှားသည့်အရေအတွက်) count_missing (ပျောက်ဆုံးနေသည့်အရေအတွက်) min (အနိမ့်ဆုံးပမာဏ) max (အမြင့်ဆုံးပမာဏ) sum (ပေါင်းလာဒ်) mean (သမတ်ကိန်း) median (တစ်ဝက်ကိန်း) stdev (စံတိမ်းချက်) stdevsample (စံတိမ်းချက်နမူနာ) range (အပိုင်းအခြားပမာဏ) minority (အနည်းစုဖြစ်သော) majority (အများစုဖြစ်သော) q1: first quartile (ဒေတာတစ်ခု၏ ပထမလေးပုံတစ်ပုံ/၂၅ ရာခိုင်နှုန်း) q3: third quartile (ဒေတာတစ်ခု၏ တတိယလေးပုံတစ်ပုံ/၇၅ ရာခိုင်နှုန်း) iqr: inter quartile range (ဒေတာ၏အလယ်တစ်ဝက်တွင် ပြန့်နှံ့မှု။ ၎င်းကို တတိယလေးပုံတစ်ပုံမှ ပထမလေးပုံတစ်ပုံကိုခြားနားခြင်းဖြင့် ရရှိနိုင်ပါသည်) min_length: အနည်းဆုံး string အရှည် max_length: အများဆုံး string အရှည် concatenate: concatenator တစ်ခုဖြင့် string များကို ချိတ်ဆက်သည် concatenate_unique: concatenator တစ်ခုဖြင့် သိသာထင်ရှားသည့် string များကို ချိတ်ဆက်သည်။ collect: များစွာသော ဂျီဩမေတြီအစိတ်အပိုင်းများကိုပေါင်းစည်းထားမှု (aggregated multipart geometry) တစ်ခုအားဖန်တီးပေးသည်။ array_agg: ပေါင်းစည်းထားသောတန်ဖိုးများ (aggregated values) ၏ array တစ်ခုကို ဖန်တီးပေးသည်။ expression - aggregate ပြုလုပ်ရန် expression အခွဲတစ်ခု သို့မဟုတ် field အမည် filter - aggregate များကို တွက်ချက်ခြင်းပြုလုပ်ရန်အတွက် အသုံးပြုသည့် feature များကို ကန့်သတ်ရန် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) filter expression။ Field များနှင့် ဂျီဩမေတြီများသည် ချိတ်ဆက်ထားသည့် layer ပေါ်ရှိ feature များမှဖြစ်ပါသည်။ ရင်းမြစ် feature ကို @parent variable ဖြင့် ရယူသုံးစွဲနိုင်ပါသည်။ concatenator - ‘concatenate’ နှင့် ‘concatenate_unique’ aggregate များအတွက် တန်ဖိုးများကို ချိတ်ဆက်ရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) string order_by - aggregate ကို တွက်ချက်မှုများပြုလုပ်ရန်အတွက်အသုံးပြုသည့် feature များကို အစဉ်လိုက်စီရန်အတွက် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) filter expression။ Field များနှင့် ဂျီဩမေတြီများသည် ချိတ်ဆက်ထားသည့် layer ပေါ်ရှိ feature များမှဖြစ်ပါသည်။ Default အားဖြင့် feature များကို သတ်မှတ်ထားခြင်း (unspecified) မရှိသည့် order (အစဉ်) ဖြင့် ပြန်လည်ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	aggregate(layer:='rail_stations',aggregate:='sum',expression:="passengers") → rail_stations layer ထဲရှိ passengers field ထဲမှ တန်ဖိုးများအားလုံး၏ ပေါင်းလဒ် aggregate('rail_stations','sum', "passengers"/7) → တန်ဖိုးများကို ပေါင်းခြင်းမပြုမီ “passengers” field ကို 7 ဖြင့်စားခြင်းဖြင့် နေ့စဉ်ပျမ်းမျှ “passengers” အား တွက်ချက်ပေးပါသည်။ aggregate(layer:='rail_stations',aggregate:='sum',expression:="passengers",filter:="class">3) → “class” attribute သည် ၃ ထက်သာ ပိုကြီးသော feature များမှ “passengers” field မှ တန်ဖိုးများအားလုံးကို ပေါင်းပေးပါသည်။ aggregate(layer:='rail_stations',aggregate:='concatenate', expression:="name", concatenator:=',') → rail_stations layer ထဲရှိ feature များအားလုံးအတွက် comma (ကော်မာ) ဖြင့်ပိုင်းခြားထားသည့် နာမည် field ၏ စာရင်း aggregate(layer:='countries', aggregate:='max', expression:="code", filter:=intersects( @geometry, geometry(@parent) ) ) → ‘countries’ layer ပေါ်တွင် ထိဖြတ်နေသည့် (intersecting) နိုင်ငံတစ်ခု၏ country code aggregate(layer:='rail_stations',aggregate:='sum',expression:="passengers",filter:=contains( @atlas_geometry, @geometry ) ) → လက်ရှိ atlas (မြေပုံစီးရီး) feature အတွင်း rail_stations ထဲရှိ passengers field မှ တန်ဖိုးများအားလုံးပေါင်းခြင်း aggregate(layer:='rail_stations', aggregate:='collect', expression:=centroid(@geometry), filter:="region_name" = attribute(@parent,'name') ) → လက်ရှိ feature အဖြစ် တူညီသော region (ဒေသ) ၏ rail_stations များ၏ အလယ်ဗဟိုဂျီသြမေတြီများ (centroid geometries) ကို စုစည်းပေးပါသည်။

13.2.1.2. array_agg

Field တစ်ခု သို့မဟုတ် expression တစ်ခုမှ စုပေါင်းထားသောတန်ဖိုးများပါရှိသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_agg(expression, [group_by], [filter], [order_by]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲများ group_by - aggregate တွက်ချက်မှုများအား အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter) - aggregate များကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression order_by - aggregate များကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို အစဉ်လိုက်စီစဉ်ဖော်ပြရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression။ Default အားဖြင့် feature များကို သတ်မှတ်ထားခြင်း (unspecified) မရှိသည့် order (အစဉ်) ဖြင့် ပြန်လည်ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	array_agg("name",group_by:="state") → state field များဖြင့် အုပ်စုခွဲထားသော အမည်တန်ဖိုးများစာရင်း

13.2.1.3. collect

Expression တစ်ခုမှ စုပေါင်းထားသောဂျီဩမေတြီများ၏ အစိတ်အပိုင်းများစွာပါသော (multipart) ဂျီဩမေတြီကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	collect(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန်အတွက် ဂျီဩမေတြီ expression group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	collect( @geometry ) → စုပေါင်းထားသော ဂျီဩမေတြီများ၏ အစိတ်အပိုင်းများစွာပါသော (multipart) ဂျီဩမေတြီ collect( centroid(@geometry), group_by:="region", filter:= "use" = 'civilian' ) → ၎င်းတို့၏ region (ဒေသ) တန်ဖိုးအပေါ်အခြေခံထားသည့် civilian feature များ၏ စုပေါင်းထားသော centroid (အလယ်ဗဟို) များ

13.2.1.4. concatenate

Delimiter (စာသားများကို ပိုင်းခြားထားသည့် , ; အစရှိသည့် character များ) တစ်ခုဖြင့် ချိတ်ဆက်ထားသည့် field သို့မဟုတ် expression တစ်ခုမှ စုပေါင်းထားသော string များအားလုံးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	concatenate(expression, [group_by], [filter], [concatenator], [order_by]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression concatenator - တန်ဖိုးများကို ချိတ်ဆက်ရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) string ။ Default အားဖြင့် Empty ဖြစ်ပါသည်။ order_by - aggregate များကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို အစဉ်လိုက်စီစဉ်ဖော်ပြရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression။ Default အားဖြင့် feature များကို သတ်မှတ်ထားခြင်း (unspecified) မရှိသည့် order (အစဉ်) ဖြင့် ပြန်လည်ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	concatenate("town_name",group_by:="state",concatenator:=',') → state field ဖြင့် အုပ်စုဖွဲ့ထားပြီး ကော်မာဖြင့်ပိုင်းခြားထားသည့် မြို့အမည်များစာရင်း

13.2.1.5. concatenate_unique

Delimiter (စာသားများကို ပိုင်းခြားထားသည့် , ; အစရှိသည့် character များ) တစ်ခုဖြင့် ချိတ်ဆက်ထားသည့် field သို့မဟုတ် expression တစ်ခုမှ သိသာထင်ရှားသည့် (unique) string များအားလုံးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	concatenate_unique(expression, [group_by], [filter], [concatenator], [order_by]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression concatenator - တန်ဖိုးများကို ချိတ်ဆက်ရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) string ။ Default အားဖြင့် Empty ဖြစ်ပါသည်။ order_by - aggregate များကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို အစဉ်လိုက်စီစဉ်ဖော်ပြရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression။ Default အားဖြင့် feature များကို သတ်မှတ်ထားခြင်း (unspecified) မရှိသည့် order (အစဉ်) ဖြင့် ပြန်လည်ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	concatenate_unique("town_name",group_by:="state",concatenator:=',') → state field ဖြင့် အုပ်စုဖွဲ့ထားပြီး ကော်မာဖြင့် ပိုင်းခြားထားသည့် သိသာထင်ရှား (unique) သောမြို့အမည်များစာရင်း

13.2.1.6. count

ကိုက်ညီမှုရှိသော feature များ၏ အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	count(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	count("stations",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် stations (ဘူတာရုံများ) အရေအတွက်

13.2.1.7. count_distinct

သိသာထင်ရှားသည့်တန်ဖိုးများ၏ အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	count_distinct(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	count_distinct("stations",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် သိသာထင်ရှားသည့် stations (ဘူတာရုံများ) အရေအတွက်

13.2.1.8. count_missing

ပျောက်ဆုံးနေသည့် (NULL) တန်ဖိုးများ၏ အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	count_missing(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	count_missing("stations",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားပြီး ပျောက်ဆုံးနေသည့် (NULL) station (ဘူတာရုံ) တန်ဖိုးများ၏အရေအတွက်

13.2.1.9. iqr

Field သို့မဟုတ် expression တစ်ခုမှ တွက်ချက်ထားသည့် inter quartile range ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	iqr(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	iqr("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး၏ inter quartile range

13.2.1.10. majority

Field သို့မဟုတ် expression တစ်ခုမှ တန်ဖိုးများ (အများဆုံး ဖြစ်ပွားလေ့ရှိသည့်တန်ဖိုး) ၏ aggregate majority (အများစု) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	majority(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	majority("class",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် အများဆုံး ဖြစ်ပွားလေ့ရှိသော အတန်းအစားတန်ဖိုး

13.2.1.11. max_length

Field သို့မဟုတ် expression တစ်ခုမှ string များ၏ အရှည်ဆုံးအလျား ကိုပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	max_length(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	max_length("town_name",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် မြို့အမည် (town_name) များ၏ အရှည်ဆုံးအလျား

13.2.1.12. maximum

Field သို့မဟုတ် expression တစ်ခုမှ aggregate maximum value (စုပေါင်းစည်းထားသည့်အများဆုံးတန်ဖိုး) ကိုပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	maximum(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	maximum("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် အများဆုံးလူဦးရေတန်ဖိုး

13.2.1.13. mean

Field သို့မဟုတ် expression တစ်ခုမှ aggregate mean value (ပေါင်းစည်းထားသည့်ပျမ်းမျှတန်ဖိုး) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	mean(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	mean("population",group_by:="state") → state(ပြည်နယ်) field ဖြင့် အုပ်စုခွဲထားသည့် ပျမ်းမျှလူဦးရေတန်ဖိုး

13.2.1.14. median

Field သို့မဟုတ် expression တစ်ခုမှ aggregate median value (ပေါင်းစည်းထားသည့်တစ်ဝက်ကိန်းတန်ဖိုး) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	median(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	median("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး၏ တစ်ဝက်ကိန်း

13.2.1.15. min_length

Field သို့မဟုတ် expression တစ်ခုမှ string များ၏ အနည်းဆုံးအလျားကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	min_length(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	min_length("town_name",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် မြို့အမည် (town_name) များ၏ အနည်းဆုံးအလျား

13.2.1.16. minimum

Field သို့မဟုတ် expression တစ်ခုမှ aggregate minimum value (ပေါင်းစည်းထားသည့်အနည်းဆုံးတန်ဖိုး) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	minimum(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	minimum("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် အနည်းဆုံးလူဦးရေတန်ဖိုး

13.2.1.17. minority

Field သို့မဟုတ် expression တစ်ခုမှ တန်ဖိုးများ (အနည်းဆုံး ဖြစ်ပွားလေ့ရှိသည့်တန်ဖိုး) ၏ aggregate majority (အနည်းစု) ကိုပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	minority(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	minority("class",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် အနည်းဆုံး ဖြစ်ပွားလေ့ရှိသည့် အတန်းအစားတန်ဖိုး

13.2.1.18. q1

Field သို့မဟုတ် expression တစ်ခုမှ တွက်ချက်ထားသည့် ပထမလေးပုံတစ်ပုံ/၂၅ ရာခိုင်နှုန်း (first quartile) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	q1(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	q1("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး၏ ပထမလေးပုံတစ်ပုံ/၂၅ ရာခိုင်နှုန်း

13.2.1.19. q3

Field သို့မဟုတ် expression တစ်ခုမှ တွက်ချက်ထားသည့် တတိယလေးပုံတစ်ပုံ/၇၅ရာခိုင်နှုန်း (third quartile) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	q3(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	q3("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး၏ တတိယလေးပုံတစ်ပုံ/၇၅ရာခိုင်နှုန်း

13.2.1.20. range

Field သို့မဟုတ် expression တစ်ခုမှ တန်ဖိုးများ၏ aggregate range (အပိုင်းအခြားပမာဏ) (အနည်းဆုံး-အများဆုံး) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	range(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	range("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး အပိုင်းအခြားပမာဏ

13.2.1.21. relation_aggregate

Layer relation (ဆက်နွယ်ချက်) တစ်ခုမှ ကိုက်ညီသည့် child feature များကိုအသုံးပြုပြီး တွက်ချက်ထားသည့် aggregate တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	relation_aggregate(relation, aggregate, expression, [concatenator=’’], [order_by]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	relation - relation ID တစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု aggregate - တွက်ချက်မှုများပြုလုပ်ရန် aggregate နှင့်သက်ဆိုင်သော string တစ်ခု။ ရရှိနိုင်သည့် နည်းလမ်းများမှာ- count (အရေအတွက်) count_distinct (ထင်ရှားသည့်အရေအတွက်) count_missing (ပျောက်ဆုံးနေသည့်အရေအတွက်) min (အနိမ့်ဆုံးပမာဏ) max (အမြင့်ဆုံးပမာဏ) sum (ပေါင်းလာဒ်) mean (သမတ်ကိန်း) median (တစ်ဝက်ကိန်း) stdev (စံတိမ်းချက်) stdevsample (စံတိမ်းချက်နမူနာ) range (အပိုင်းအခြားပမာဏ) minority (အနည်းစုဖြစ်သော) majority (အများစုဖြစ်သော) q1: first quartile (ဒေတာတစ်ခု၏ ပထမလေးပုံတစ်ပုံ/၂၅ ရာခိုင်နှုန်း) q3: third quartile (ဒေတာတစ်ခု၏ တတိယလေးပုံတစ်ပုံ/၇၅ ရာခိုင်နှုန်း) iqr: inter quartile range (ဒေတာ၏အလယ်တစ်ဝက်တွင် ပြန့်နှံ့မှု။ ၎င်းကို တတိယလေးပုံတစ်ပုံမှ ပထမလေးပုံတစ်ပုံကိုခြားနားခြင်းဖြင့် ရရှိနိုင်ပါသည်) min_length: အနည်းဆုံး string အရှည် max_length: အများဆုံး string အရှည် concatenate: concatenator တစ်ခုဖြင့် string များကို ချိတ်ဆက်သည် concatenate_unique: concatenator တစ်ခုဖြင့် သိသာထင်ရှားသည့် string များကို ချိတ်ဆက်သည်။ collect: များစွာသော ဂျီဩမေတြီအစိတ်အပိုင်းများကိုပေါင်းစည်းထားမှု (aggregated multipart geometry) တစ်ခုအားဖန်တီးပေးသည်။ array_agg: ပေါင်းစည်းထားသောတန်ဖိုးများ (aggregated values) ၏ array တစ်ခုကို ဖန်တီးပေးသည်။ expression - aggregate ပြုလုပ်ရန် expression အခွဲ သို့မဟုတ် field အမည် concatenator - ‘concatenate’ aggregate အတွက် တန်ဖိုးများကို ချိတ်ဆက်ရန် အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) string order_by - aggregate ကို တွက်ချက်မှုများပြုလုပ်ရန်အတွက်အသုံးပြုသည့် feature များကို အစဉ်လိုက်စီရန်အတွက် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression ။ Field များနှင့် ဂျီဩမေတြီများသည် ချိတ်ဆက်ထားသည့် layer ပေါ်ရှိ feature များမှဖြစ်ပါသည်။ Default အားဖြင့် feature များကို သတ်မှတ်ထားခြင်း (unspecified) မရှိသည့် order (အစဉ်) ဖြင့် ပြန်လည်ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	relation_aggregate(relation:='my_relation',aggregate:='mean',expression:="passengers") → ‘my_relation’ relation ကို အသုံးပြုပြီး ကိုက်ညီမှုရှိသော child feature များအားလုံး၏ သမတ်ကိန်းတန်ဖိုး relation_aggregate('my_relation','sum', "passengers"/7) → ‘my_relation’ relation ကို အသုံးပြုပြီး ကိုက်ညီမှုရှိသော child feature များအားလုံးအတွက် 7 ဖြင့် စားထားသည့် passengers field ၏ ပေါင်းလဒ် aggregate(layer:='countries', aggregate:='max', expression:="code", filter:=intersects( @geometry, geometry(@parent) ) ) → ‘countries’ layer ပေါ်တွင် ထိဖြတ်သည့် (intersecting) နိုင်ငံတစ်ခု၏ country code relation_aggregate('my_relation','concatenate', "towns", concatenator:=',') → ‘my_relation’ relation ကို အသုံးပြုပြီး ကိုက်ညီမှုရှိသော child feature များအားလုံးအတွက် ကော်မာဖြင့်ပိုင်းခြားထားသည့် towns field ၏ စာရင်း relation_aggregate('my_relation','array_agg', "id") → ‘my_relation’ relation ကို အသုံးပြုပြီး ကိုက်ညီမှုရှိသော child feature များအားလုံးမှ id field ၏ array

ထပ်မံဖတ်ရှုရန်- တစ်ခု-မှ-အများ သို့မဟုတ် အများ-မှ-အများ ဆက်သွယ်ချက်များကို ဖန်တီးခြင်း (Creating one or many to many relations)

13.2.1.22. stdev

Field သို့မဟုတ် expression တစ်ခုမှ စုပေါင်းထားသည့်စံတိမ်းချက်တန်ဖိုး (aggregate standard deviation value) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	stdev(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	stdev("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုး၏ စံတိမ်းချက်

13.2.1.23. sum

Field သို့မဟုတ် expression တစ်ခုမှ aggregate summed value (စုပေါင်းထားသော စုစုပေါင်းတန်ဖိုး) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sum(expression, [group_by], [filter]) [] သည် optional (မဖြစ်မနေထည့်သွင်းရန်မလိုသော) argument များဖြစ်သည်
Argument များ	expression - aggregate ပြုလုပ်ရန် field ၏ expression အခွဲ group_by - aggregate တွက်ချက်မှုများကို အုပ်စုဖွဲ့ရာတွင် အသုံးပြုမည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression filter - aggregate ကို တွက်ချက်ရာတွင် အသုံးပြုသည့် feature များကို စစ်ထုတ်ရန်အသုံးပြုသည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) expression
ဥပမာများ	sum("population",group_by:="state") → state field ဖြင့် အုပ်စုဖွဲ့ထားသည့် လူဦးရေတန်ဖိုးစုစုပေါင်း

13.2.2. Array Functions များ

ဤအုပ်စုတွင် array (အစီအစဉ်) များကို ဖန်တီးရန်နှင့် ကိုင်တွယ်ရန် function များ ပါရှိသည် (Data တည်ဆောက်ပုံများ စာရင်းဟုလည်း ခေါ်ဆိုသည်)။ Array အတွင်းရှိတန်ဖိုးများ၏ အစဥ် (order) သည် အရေးကြီးသော ‘map’ data structure (‘မြေပုံ’ Data တည်ဆောက်ပုံ) နှင့်မတူပဲ key-value pairs (key-တန်ဖိုး အတွဲများ) ၏ order သည် မဆက်စပ်ပဲ တန်ဖိုးများကို ၄င်းတို့၏ key များဖြင့် သတ်မှတ်ထားပါသည်။

13.2.2.1. array

Parameter အဖြစ် မှတ်ယူသည့် တန်ဖိုးများအားလုံးပါဝင်သော array (အတိုင်းလိုက် ဒေါင်လိုက် စီစဉ်ထားသော ကိန်းစု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array(value1, value2, …)
Argument များ	value - တန်ဖိုးတစ်ခု
ဥပမာများ	array(2,10) → [ 2, 10 ] array(2,10)[0] → 2

13.2.2.2. array_all

အကယ်၍ array တစ်ခုသည် ပေးထားသည့် array တစ်ခု၏ တန်ဖိုးများအားလုံးပါဝင်ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_all(array_a, array_b)
Argument များ	array_a - array တစ်ခု array_b - ရှာဖွေမှုပြုလုပ်ရန် တန်ဖိုးများ၏ array
ဥပမာများ	array_all(array(1,2,3),array(2,3)) → TRUE array_all(array(1,2,3),array(1,2,4)) → FALSE

13.2.2.3. array_append

ပေးထားသော တန်ဖိုးကို အဆုံးတွင် ထည့်သွင်းထားရှိသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_append(array, value)
Argument များ	array - array တစ်ခု value - ထည့်သွင်းရန် တန်ဖိုး
ဥပမာများ	array_append(array(1,2,3),4) → [ 1၊ 2၊ 3၊ 4 ]

13.2.2.4. array_cat

ပေါင်းစပ်ခြင်းများပြုလုပ်ထားသည့် array များအားလုံးပါဝင်သော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_cat(array1, array2, …)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_cat(array(1,2),array(2,3)) → [ 1, 2, 2, 3 ]

13.2.2.5. array_contains

အကယ်၍ array တစ်ခုသည် ပေးထားသည့် တန်ဖိုးပါဝင်ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_contains(array, value)
Argument များ	array - array တစ်ခု value - ရှာဖွေမှုပြုလုပ်ရန် တန်ဖိုး
ဥပမာများ	array_contains(array(1,2,3),2) → TRUE

13.2.2.6. array_count

Array တစ်ခုထဲတွင် ပေးထားသည့် တန်ဖိုးတစ်ခု၏ ဖြစ်ပွားသည့် အကြိမ်အရေအတွက်ကို ရေတွက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_count(array, value)
Argument များ	array - array တစ်ခု value - ရေတွက်မှု (count) ပြုလုပ်ရန် တန်ဖိုး
ဥပမာများ	array_count(array('a', 'b', 'c', 'b'), 'b') → 2

13.2.2.7. array_distinct

ပေးထားသည့် array ၏ သိသာထင်ရှားသည့်တန်ဖိုးများပါဝင်သော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_distinct(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_distinct(array(1,2,3,2,1)) → [ 1, 2, 3 ]

13.2.2.8. array_filter

Expression သည် true အဖြစ်သို့ အကဲဖြတ်သတ်မှတ်ထားသည့် အရာများ (items) သာပါရှိသော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_filter(array, expression, [limit=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	array - array တစ်ခု expression - ပါဝင်သည့်အရာ (item) တစ်ခုချင်းစီအပေါ်တွင် အကဲဖြတ်မှု(evaluate) ပြုလုပ်ရန် expression တစ်ခု။ @element variable (ကိန်းရှင်) ကို လက်ရှိတန်ဖိုးဖြင့် အစားထိုးလိမ့်မည်ဖြစ်ပါသည်။ limit - ပြန်ထုတ်ပေးသည့် element (array တစ်ခုရှိ item တစ်ခုစီကို element ဟုခေါ်သည်) များ၏ အများဆုံးအရေအတွက်။ တန်ဖိုးများအားလုံးကို ပြန်ထုတ်ပေးရန် 0 ကို အသုံးပြုပါ။
ဥပမာများ	array_filter(array(1,2,3),@element < 3) → [ 1, 2 ] array_filter(array(1,2,3),@element < 3, 1) → [ 1 ]

13.2.2.9. array_find

Array တစ်ခုထဲရှိ တန်ဖိုးတစ်ခု၏ အနိမ့်ဆုံး အညွှန်း (index) (ပထမဆုံး တစ်ခုအတွက် 0) ကို ရရှိစေပါသည်။ အကယ်၍ တန်ဖိုးကို မတွေ့ရှိပါက -1 ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_find(array, value)
Argument များ	array - array တစ်ခု value - ရှာဖွေမှုပြုလုပ်ရန် တန်ဖိုး
ဥပမာများ	array_find(array('a', 'b', 'c'), 'b') → 1 array_find(array('a', 'b', 'c', 'b'), 'b') → 1

13.2.2.10. array_first

Array တစ်ခု၏ ပထမဦးဆုံး တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_first(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_first(array('a','b','c')) → ‘a’

13.2.2.11. array_foreach

ပါဝင်သည့်အရာ (item) တစ်ခုချင်းစီအပေါ်တွင် အကဲဖြတ်မှုပြုလုပ်ထားသော ပေးထားသည့် expression တစ်ခုပါရှိသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_foreach(array, expression)
Argument များ	array - array တစ်ခု expression - ပါဝင်သည့်အရာ (item) တစ်ခုချင်းစီအပေါ်တွင် အကဲဖြတ်မှုပြုလုပ်ရန် expression တစ်ခု။ @element variable (ကိန်းရှင်) ကို လက်ရှိတန်ဖိုးဖြင့် အစားထိုးသွားမည်ဖြစ်ပါသည်။
ဥပမာများ	array_foreach(array('a','b','c'),upper(@element)) → [ ‘A’, ‘B’, ‘C’ ] array_foreach(array(1,2,3),@element + 10) → [ 11, 12, 13 ]

13.2.2.12. array_get

Array တစ်ခု၏ Nth တန်ဖိုး (ပထမဦးဆုံးတစ်ခုအတွက် 0) သို့မဟုတ် -Nth တန်ဖိုး (နောက်ဆုံးတစ်ခုအတွက် -1) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_get(array, pos)
Argument များ	array - array တစ်ခု pos - ရယူရန်အညွှန်း (index) (0 မှစတင်သော)
ဥပမာများ	array_get(array('a','b','c'),1) → ‘b’ array_get(array('a','b','c'),-1) → ‘c’

Hint

Array တစ်ခုမှ တန်ဖိုးတစ်ခုရရှိရန် index operator ([]) ကိုလည်း အသုံးပြုနိုင်ပါသည်။

13.2.2.13. array_insert

ပေးထားသည့် နေရာ (position) တွင် ပေးထားသည့် တန်ဖိုးကို ထည့်သွင်းထားသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_insert(array, pos, value)
Argument များ	array - array တစ်ခု pos - ပေါင်းထည့်မည့် နေရာ (0 မှစတင်သော) value - ပေါင်းထည့်ရန် တန်ဖိုး
ဥပမာများ	array_insert(array(1,2,3),1,100) → [ 1, 100, 2, 3 ]

13.2.2.14. array_intersect

အကယ်၍ array2 ထဲတွင် array1 ၏ element အနည်းဆုံးတစ်ခုပါဝင်နေပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_intersect(array1, array2)
Argument များ	array1 - array တစ်ခု array2 - အခြား array
ဥပမာများ	array_intersect(array(1,2,3,4),array(4,0,2,5)) → TRUE

13.2.2.15. array_last

Array တစ်ခု၏ နောက်ဆုံးတန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_last(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_last(array('a','b','c')) → ‘c’

13.2.2.16. array_length

Array တစ်ခု၏ element အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_length(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_length(array(1,2,3)) → 3

13.2.2.17. array_majority

Array တစ်ခုထဲတွင် အများဆုံး မြင်တွေ့ရသည့် တန်ဖိုးများကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_majority(array, [option=’all’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	array - array တစ်ခု option=’all’ - ပြန်ထုတ်ပေးမည့်တန်ဖိုးများကို ကိုင်တွယ်ဆောင်ရွက်မှုများပြုလုပ်ရန် သတ်မှတ်သည့် string တစ်ခု။ ရရှိနိုင်သည့်နည်းလမ်းများမှာ- all - Default ဖြစ်သည်၊ array တစ်ခုထဲတွင် အများဆုံး တွေ့ရသည့် တန်ဖိုးများအားလုံးကို ပြန်ထုတ်ပေးပါသည်။ any - အများဆုံး တွေ့ရရှိသည့် တန်ဖိုးများထဲမှ တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ median - အများဆုံး တွေ့ရရှိသည့် တန်ဖိုးများ၏ တစ်ဝက်ကိန်း (median) ကို ပြန်ထုတ်ပေးပါသည်။ ဂဏန်းသင်္ချာမဟုတ်သော တန်ဖိုးများကို လျစ်လျူရှုမည် ဖြစ်သည်။ real_majority - array အရွယ်အစား၏တစ်ဝက်ထက် ပိုပြီး တွေ့ရသည့် တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။
ဥပမာများ	array_majority(array(0,1,42,42,43), 'all') → [ 42 ] array_majority(array(0,1,42,42,43,1), 'all') → [ 42, 1 ] array_majority(array(0,1,42,42,43,1), 'any') → 1 or 42 array_majority(array(0,1,1,2,2), 'median') → 1.5 array_majority(array(0,1,42,42,43), 'real_majority') → NULL array_majority(array(0,1,42,42,43,42), 'real_majority') → NULL array_majority(array(0,1,42,42,43,42,42), 'real_majority') → 42

13.2.2.18. array_max

Array တစ်ခု၏ အများဆုံးတန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_max(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_max(array(0,42,4,2)) → 42

13.2.2.19. array_mean

Array တစ်ခုထဲရှိ သင်္ချာဂဏန်းတန်ဖိုးများ (arithmetic values) ၏ သမတ်ကိန်း (mean) ကို ပြန်ထုတ်ပေးပါသည်။ ဂဏန်းသင်္ချာမဟုတ်သော တန်ဖိုးများကို လျစ်လျူရှုမည် ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_mean(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_mean(array(0,1,7,66.6,135.4)) → 42 array_mean(array(0,84,'a','b','c')) → 42

13.2.2.20. array_median

Array တစ်ခုထဲရှိ သင်္ချာဂဏန်းတန်ဖိုးများ (arithmetic values) ၏ တစ်ဝက်ကိန်း (median) ကို ပြန်ထုတ်ပေးပါသည်။ ဂဏန်းသင်္ချာမဟုတ်သော တန်ဖိုးများကို လျစ်လျူရှုမည် ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_median(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_median(array(0,1,42,42,43)) → 42 array_median(array(0,1,2,42,'a','b')) → 1.5

13.2.2.21. array_min

Array တစ်ခု၏ အနည်းဆုံးတန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_min(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_min(array(43,42,54)) → 42

13.2.2.22. array_minority

Array တစ်ခုထဲတွင် အနည်းဆုံး မြင်တွေ့ရသည့်တန်ဖိုးများ (less common values) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_minority(array, [option=’all’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	array - array တစ်ခု option=’all’ - ပြန်ထုတ်ပေးမည့်တန်ဖိုးများကို ကိုင်တွယ်ဆောင်ရွက်မှုများပြုလုပ်ရန် သတ်မှတ်သည့် string တစ်ခု။ ရရှိနိုင်သည့်နည်းလမ်းများမှာ- all - Default ဖြစ်သည်၊ array တစ်ခုထဲတွင် အနည်းဆုံး မြင်တွေ့ရသည့် တန်ဖိုးများအားလုံးကို ပြန်ထုတ်ပေးပါသည်။ any - အနည်းဆုံး မြင်တွေ့ရသည့် တန်ဖိုးများထဲမှ တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ median - အနည်းငယ်သာ မြင်တွေ့ရသည့် တန်ဖိုးများ၏ တစ်ဝက်ကိန်း (median) ကို ပြန်ထုတ်ပေးပါသည်။ ဂဏန်းသင်္ချာမဟုတ်သော တန်ဖိုးများကို လျစ်လျူရှုမည် ဖြစ်ပါသည်။ real_majority - array အရွယ်အစား၏ တစ်ဝက်အောက် ဖြစ်ပွားမှုနည်းသည့် တန်ဖိုးများကို ပြန်ထုတ်ပေးပါသည်။
ဥပမာများ	array_minority(array(0,42,42), 'all') → [ 0 ] array_minority(array(0,1,42,42), 'all') → [ 0, 1 ] array_minority(array(0,1,42,42,43,1), 'any') → 0 or 43 array_minority(array(1,2,3,3), 'median') → 1.5 array_minority(array(0,1,42,42,43), 'real_minority') → [ 42, 43, 0, 1 ] array_minority(array(0,1,42,42,43,42), 'real_minority') → [ 42, 43, 0, 1 ] array_minority(array(0,1,42,42,43,42,42), 'real_minority') → [ 43, 0, 1 ]

13.2.2.23. array_prepend

ပေးထားသည့်တန်ဖိုးကို အစတွင် ပေါင်းထည့်ထားသော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_prepend(array, value)
Argument များ	array - array တစ်ခု value - ထည့်သွင်းရန်တန်ဖိုး
ဥပမာများ	array_prepend(array(1,2,3),0) → [ 0, 1, 2, 3 ]

13.2.2.24. array_prioritize

အခြား array ထဲရှိ သတ်မှတ်ထားသည့် အစဉ်လိုက်စီစဉ်ထားရှိမှု (ordering) ကို အသုံးပြုပြီး စီစဉ်ထားရှိထား (sorted) သည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ ပထမ array ထဲတွင် ရှိသော်လည်း ဒုတိယ array မှ ပျောက်ဆုံးနေသည့် တန်ဖိုးများကို ရလာဒ်၏ အဆုံးတွင် ထည့်သွင်းသွားမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_prioritize(array, array_prioritize)
Argument များ	array - array တစ်ခု array_prioritize - တန်ဖိုးများကို priority (ဦးစားပေးမှုအလိုက်) ဖြင့် စီစဉ်ထားရှိသည့် array တစ်ခု
ဥပမာများ	array_prioritize(array(1, 8, 2, 5), array(5, 4, 2, 1, 3, 8)) → [ 5, 2, 1, 8 ] array_prioritize(array(5, 4, 2, 1, 3, 8), array(1, 8, 6, 5)) → [ 1, 8, 5, 4, 2, 3 ]

13.2.2.25. array_remove_all

ပေးထားသည့် တန်ဖိုး၏ entry (ထည့်သွင်းထားသည့်အချက်အလက်များ) အားလုံးကို ဖယ်ရှားထားသော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_remove_all(array, value)
Argument များ	array - array တစ်ခု value - ဖယ်ရှားမည့်တန်ဖိုးများ
ဥပမာများ	array_remove_all(array('a','b','c','b'),'b') → [ ‘a’, ‘c’ ]

13.2.2.26. array_remove_at

ပေးထားသည့် အညွှန်း (index) ၌ရှိသည့် item ကို ဖယ်ရှားထားသော array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အပေါင်း (ပထမ element အတွက် 0) နှင့် အနုတ် (နောက်ဆုံး -Nth တန်ဖိုး ၊ နောက်ဆုံး element အတွက် -1) အညွှန်းကို အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_remove_at(array, pos)
Argument များ	array - array တစ်ခု pos - ဖယ်ရှားမည့် နေရာ (0 မှစတင်သော)
ဥပမာများ	array_remove_at(array(1, 2, 3), 1) → [1, 3 ] array_remove_at(array(1, 2, 3), -1) → [1, 2 ]

13.2.2.27. array_replace

အစားထိုးထားသည့် ပေးထားသော တန်ဖိုး၊ array သို့မဟုတ် တန်ဖိုးများ၏မြေပုံပါရှိသည့် array တစ်ခုအား ပြန်ထုတ်ပေးပါသည်။

Value & array variant (တန်ဖိုး နှင့် array မူကွဲ)

ပေးထားသော တန်ဖိုး သို့မဟုတ် တန်ဖိုးများ၏ array တစ်ခုကို အခြားတန်ဖိုး သို့မဟုတ် တန်ဖိုးများ၏ array တစ်ခုဖြင့် အစားထိုးထားသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_replace(array, before, after)
Argument များ	array - ထည့်သွင်းအသုံးပြုမည့် array before - အစားထိုးရန် တန်ဖိုး သို့မဟုတ် တန်ဖိုးများ၏ array after - အစားထိုးမှု (replacement) တစ်ခုအဖြစ် အသုံးပြုရန် တန်ဖိုး သို့မဟုတ် တန်ဖိုးများ၏ array
ဥပမာများ	array_replace(array('QGIS','SHOULD','ROCK'),'SHOULD','DOES') → [ ‘QGIS’, ‘DOES’, ‘ROCK’ ] array_replace(array(3,2,1),array(1,2,3),array(7,8,9)) → [ 9, 8, 7 ] array_replace(array('Q','G','I','S'),array('Q','S'),'-') → [ ‘-’, ‘G’, ‘I’, ‘-’ ]

Map variant (ဖော်ပြမှုမူကွဲ)

၎င်းတို့၏ တွဲဖက်တန်ဖိုးများ (paired values) ဖြင့် အစားထိုးထားသည့် ပေးထားသော map key များပါရှိသည့် array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_replace(array, map)
Argument များ	array - ထည့်သွင်းအသုံးပြုမည့် array map - key များနှင့် တန်ဖိုးများပါဝင်သော ဖော်ပြမှု (map)
ဥပမာများ	array_replace(array('APP', 'SHOULD', 'ROCK'),map('APP','QGIS','SHOULD','DOES')) → [ ‘QGIS’, ‘DOES’, ‘ROCK’ ]

13.2.2.28. array_reverse

ပေးထားသည့် array ကို array တန်ဖိုးများအား ပြောင်းပြန်စီစဉ်ထားမှုဖြင့် (reversed order) ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_reverse(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_reverse(array(2,4,0,10)) → [ 10, 0, 4, 2 ]

13.2.2.29. array_slice

Array ၏ အစိတ်အပိုင်း (portion) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ ရယူလိုသည့် slice (အစိတ်အပိုင်း) အား start_pos (အစနေရာ) နှင့် end_pos (အဆုံးနေရာ) argument များဖြင့် သတ်မှတ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_slice(array, start_pos, end_pos)
Argument များ	array - array တစ်ခု start_pos - slice (အစိတ်အပိုင်း) ၏ စတင်ရာနေရာ၏ အညွှန်း (index) (0 မှစတင်သော) start_pos index သည် slice ထဲတွင်ပါဝင်ပါသည်။ အကယ်၍ အနှုတ် (-) start_pos အသုံးပြုပါက index ကို စာရင်း၏ အဆုံး (-1 မှစတင်သော) မှ စတင်ရေတွက်ပါသည်။ * end_pos - slice (အစိတ်အပိုင်း) ၏ အဆုံးနေရာ၏ အညွှန်း (index) (0 မှစတင်သော) end_pos index သည် slice ထဲတွင်ပါဝင်ပါသည်။ အကယ်၍ အနှုတ် (-) start_pos အသုံးပြုပါက index ကို စာရင်း၏ အဆုံး (-1 မှစတင်သော) မှ စတင်ရေတွက်ပါသည်။
ဥပမာများ	array_slice(array(1,2,3,4,5),0,3) → [ 1, 2, 3, 4 ] array_slice(array(1,2,3,4,5),0,-1) → [ 1, 2, 3, 4, 5 ] array_slice(array(1,2,3,4,5),-5,-1) → [ 1, 2, 3, 4, 5 ] array_slice(array(1,2,3,4,5),0,0) → [ 1 ] array_slice(array(1,2,3,4,5),-2,-1) → [ 4, 5 ] array_slice(array(1,2,3,4,5),-1,-1) → [ 5 ] array_slice(array('Dufour','Valmiera','Chugiak','Brighton'),1,2) → [ ‘Valmiera’, ‘Chugiak’ ] array_slice(array('Dufour','Valmiera','Chugiak','Brighton'),-2,-1) → [ ‘Chugiak’, ‘Brighton’ ]

13.2.2.30. array_sort

ပေးထားသည့် array ၏ element များကို sort (စီစဉ်) ပြုလုပ်ပြီး ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_sort(array, [ascending=true]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	array - array တစ်ခု ascending - array ကို ကြီးစဉ်ငယ်လိုက်စီရန် ဤ parameter ကို false ဟု သတ်မှတ်ပါ။
ဥပမာများ	array_sort(array(3,2,1)) → [ 1, 2, 3 ]

13.2.2.31. array_sum

Array တစ်ခုထဲရှိ ဂဏန်းသင်္ချာတန်ဖိုး (arithmetic values) များ၏ ပေါင်းလဒ်ကို ပြန်ထုတ်ပေးပါသည်။ Array ထဲရှိ ဂဏန်းသင်္ချာတန်ဖိုးမဟုတ်သည့် တန်ဖိုးများကို လျစ်လျူရှုထားမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_sum(array)
Argument များ	array - array တစ်ခု
ဥပမာများ	array_sum(array(0,1,39.4,1.6,'a')) → 42.0

13.2.2.32. array_to_string

ဗလာတန်ဖိုးများအတွက် နှစ်သက်ရာ string ကို အသုံးပြုပြီး array element များကို Delimiter (text string များကို ပိုင်းခြားထားသည့် , ၊ ; ၊ “, ကဲ့သို့သော တစ်ခုထက်ပိုသည့် character များ) တစ်ခုဖြင့် ပိုင်းခြားထားသည့် string တစ်ခုအဖြစ် ပေါင်းစပ် (Concatenate) ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	array_to_string(array, [delimiter=’,’], [empty_value=’’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	array - ထည့်သွင်းမည့် array delimiter - ပေါင်းစပ်မှုပြုလုပ်ထားသည့် array element များကို ပိုင်းခြားရန် အသုံးပြုသည့် string delimiter empty_value - ဗလာဖြစ်နေသောနေရာများအတွက် အစားထိုးမှုအဖြစ်အသုံးပြုရန် နှစ်သက်ရာထည့်နိုင်သော string
ဥပမာများ	array_to_string(array('1','2','3')) → ‘1,2,3’ array_to_string(array(1,2,3),'-') → ‘1-2-3’ array_to_string(array('1','','3'),',','0') → ‘1,0,3’

13.2.2.33. generate_series

ကိန်းဂဏန်းများ၏ sequence (ကိန်းစဉ်) တစ်ခုပါဝင်သော array တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	generate_series(start, stop, [step=1]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	start - sequence (ကိန်းစဉ်) ၏ ပထမဆုံးတန်ဖိုး stop - ရောက်ရှိသည်နှင့်တပြိုင်နက် sequence (ကိန်းစဉ်) ကိုအဆုံးသတ်သော တန်ဖိုး step - တန်ဖိုးများအကြားတွင် တိုးပွားလာမှု (increment) အဖြစ် အသုံးပြုသည့်တန်ဖိုး
ဥပမာများ	generate_series(1,5) → [ 1, 2, 3, 4, 5 ] generate_series(5,1,-1) → [ 5, 4, 3, 2, 1 ]

13.2.2.34. geometries_to_array

ဂျီဩမေတြီ တစ်ခုကို array တစ်ခုထဲတွင် ပိုမိုရိုးရှင်းသည့် ဂျီဩမေတြီများအဖြစ်သို့ ခွဲထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geometries_to_array(geometry)
Argument များ	geometry - ထည့်သွင်းမည့် ဂျီဩမေတြီ
ဥပမာများ	geometries_to_array(geom_from_wkt('GeometryCollection (Polygon ((5 8, 4 1, 3 2, 5 8)),LineString (3 2, 4 2))')) → Polygon တစ်ခုနှင့် line ဂျီဩမေတြီများ တစ်ခု၏ array တစ်ခု geom_to_wkt(geometries_to_array(geom_from_wkt('GeometryCollection (Polygon ((5 8, 4 1, 3 2, 5 8)),LineString (3 2, 4 2))'))[0]) → ‘Polygon ((5 8, 4 1, 3 2, 5 8))’ geometries_to_array(geom_from_wkt('MULTIPOLYGON(((5 5,0 0,0 10,5 5)),((5 5,10 10,10 0,5 5))')) → Polygon ဂျီဩမေတြီများ နှစ်ခု၏ array တစ်ခု

13.2.2.35. regexp_matches

Capturing အုပ်စုများဖြင့် ဖမ်းယူထား (capture) သည့် string များအားလုံး၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်၊ string တစ်ခုပေါ်၌ ပေးထားသည့် regular expression ထဲတွင် အုပ်စုများ ပေါ်လာသည့် အစဉ်အတိုင်း ရရှိမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	regexp_matches(string, regex, [empty_value=’’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	string - regular expression အတိုင်း group (အုပ်စု) များကို ဖမ်းယူရန် string regex - group (အုပ်စု) များကို ဖမ်းယူရာတွင် အသုံးပြုသည့် regular expression empty_value - ဗလာနေရာများအတွက် အစားထိုးမှုအဖြစ် အသုံးပြုမည့် optional string
ဥပမာများ	regexp_matches('QGIS=>rocks','(.*)=>(.*)') → [ ‘QGIS’, ‘rocks’ ] regexp_matches('key=>','(.*)=>(.*)','empty value') → [ ‘key’, ‘empty value’ ]

13.2.2.36. string_to_array

ပေးထားသည့် Delimiter နှင့် ဗလာတန်ဖိုးများအတွက် နှစ်သက်ရာ (optional) string ကို အသုံးပြုပြီး string ကို array တစ်ခုအဖြစ်သို့ ခွဲထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	string_to_array(string, [delimiter=’,’], [empty_value=’’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	string - ထည့်သွင်းမည့် string delimiter - ထည့်သွင်းမည့် string ကို ခွဲထုတ်ရန် အသုံးပြုသည့် string delimiter empty_value - ဗလာနေရာများအတွက် အစားထိုးမှုအဖြစ်အသုံးပြုရန် optional string
ဥပမာများ	string_to_array('1,2,3',',') → [ ‘1’, ‘2’, ‘3’ ] string_to_array('1,,3',',','0') → [ ‘1’, ‘0’, ‘3’ ]

13.2.3. အရောင် Function များ (Color Functions)

ဤအုပ်စုတွင် အရောင်များကို ကိုင်တွယ်နိုင်ရန်အတွက် function များ ပါဝင်ပါသည်။

13.2.3.1. color_cmyk

အရောင်တစ်ခု၏ စိမ်းပြာရောင် (cyan)၊ ပန်းခရမ်းရောင် (magenta)၊ အဝါရောင် (yellow)နှင့် အနက်ရောင် (black) အစိတ်အပိုင်းများ (components) အပေါ်တွင် အခြေခံထားသည့် ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_cmyk(cyan, magenta, yellow, black)
Argument များ	cyan - အရောင်၏ စိမ်းပြာရောင် အစိတ်အပိုင်း (cyan component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် magenta - အရောင်၏ ပန်းခရမ်းရောင် အစိတ်အပိုင်း (magenta component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် yellow - အရောင်၏ အဝါရောင် အစိတ်အပိုင်း (yellow component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် black - အရောင်၏ အနက်ရောင် အစိတ်အပိုင်း (black component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ်
ဥပမာများ	color_cmyka(100,50,0,10,200) → ‘0,115,230,200’

13.2.3.2. color_cmyka

အရောင်တစ်ခု၏ စိမ်းပြာရောင် (cyan)၊ ပန်းခရမ်းရောင် (magenta)၊ အဝါရောင် (yellow)၊ အနက်ရောင် (black) နှင့် alpha (ဖောက်ထွင်းမြင်ရမှု) အစိတ်အပိုင်းများအပေါ်တွင် အခြေခံထားသည့် ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_cmyka(cyan, magenta, yellow, black, alpha)
Argument များ	cyan - အရောင်၏ စိမ်းပြာရောင် အစိတ်အပိုင်း (cyan component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် magenta - အရောင်၏ ပန်းခရမ်းရောင် အစိတ်အပိုင်း (magenta component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် yellow - အရောင်၏ အဝါရောင် အစိတ်အပိုင်း (yellow component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် black - အရောင်၏ အနက်ရောင် အစိတ်အပိုင်း (black component) ၊ 0 မှ 100 အထိ ရာခိုင်နှုန်းကိန်းပြည့်တန်ဖိုး တစ်ခုအဖြစ် alpha - 0 (အပြည့်အဝဖောက်ထွင်းမြင်ရသော) မှ 255 (အလင်းပိတ်သော) အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် alpha အစိတ်အပိုင်း
ဥပမာများ	color_cmyka(100,50,0,10,200) → ‘0,115,230,200’

13.2.3.3. color_grayscale_average

Grayscale filter (grayscale filter သည် element ၏ အရောင်တစ်ခုအား မီးခိုးရောင် shade အဖြစ်သို့ ပြောင်းလဲခြင်းကိုလုပ်ဆောင်နိုင်ပါသည်) တစ်ခုကို အသုံးပြုပေးပြီး ပေးထားသည့် အရောင်တစ်ခုမှ string representation တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_grayscale_average(color)
Argument များ	color - color string တစ်ခု
ဥပမာများ	color_grayscale_average('255,100,50') → ‘135,135,135,255’

13.2.3.4. color_hsl

အရောင်တစ်ခု၏ hue (အရောင်အဆင်း)၊ Saturation (အရောင်တောက်ပမှုပမာဏ)၊ lightness (အလင်းရရှိမှု) အချက်အလက်များအပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_hsl(hue, saturation, lightness)
Argument များ	hue - အရောင်၏ hue(အရောင်အဆင်း)၊ 0 မှ 360 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် saturation - အရောင်၏ saturation (အရောင်တောက်ပမှုပမာဏ) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် lightness - အရောင်၏ lightness (အလင်းရရှိမှု) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ်
ဥပမာများ	color_hsl(100,50,70) → ‘166,217,140’

13.2.3.5. color_hsla

အရောင်တစ်ခု၏ hue (အရောင်အဆင်း)၊ Saturation (အရောင်တောက်ပမှုပမာဏ)၊ lightness (အလင်းရရှိမှု) နှင့် alpha (ဖောက်ထွင်းမြင်ရမှု) အချက်အလက်များအပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_hsla(hue, saturation, lightness, alpha)
Argument များ	hue - အရောင်၏ hue(အရောင်အဆင်း)၊ 0 မှ 360 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် saturation - အရောင်၏ saturation (အရောင်တောက်ပမှုပမာဏ) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် lightness - အရောင်၏ lightness (အလင်းရရှိမှု) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် alpha - 0 (အပြည့်အဝဖောက်ထွင်းမြင်ရသော) မှ 255 (အလင်းပိတ်သော) အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် alpha အစိတ်အပိုင်း
ဥပမာများ	color_hsla(100,50,70,200) → ‘166,217,140,200’

13.2.3.6. color_hsv

အရောင်တစ်ခု၏ hue (အရောင်အဆင်း)၊ Saturation (အရောင်တောက်ပမှုပမာဏ)၊ value (တန်ဖိုး) အချက်အလက်များအပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_hsv(hue, saturation, value)
Argument များ	hue - အရောင်၏ hue(အရောင်အဆင်း)၊ 0 မှ 360 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် saturation - အရောင်၏ saturation (အရောင်တောက်ပမှုပမာဏ) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် value - 0 မှ 100 အထိ ကိန်းပြည့်တစ်ခုအဖြစ် အရောင်တစ်ခု၏ တန်ဖိုးရာခိုင်နှုန်း
ဥပမာများ	color_hsv(40,100,100) → ‘255,170,0’

13.2.3.7. color_hsva

အရောင်တစ်ခု၏ hue (အရောင်အဆင်း)၊ Saturation (အရောင်တောက်ပမှုပမာဏ)၊ value (တန်ဖိုး) နှင့် alpha (ဖောက်ထွင်းမြင်ရမှု) အချက်အလက်များအပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_hsva(hue, saturation, value, alpha)
Argument များ	hue - အရောင်၏ hue(အရောင်အဆင်း)၊ 0 မှ 360 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် saturation - အရောင်၏ saturation (အရောင်တောက်ပမှုပမာဏ) ရာခိုင်နှုန်း၊ 0 မှ 100 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် value - 0 မှ 100 အထိ ကိန်းပြည့်တစ်ခုအဖြစ် အရောင်တစ်ခု၏ တန်ဖိုးရာခိုင်နှုန်း alpha - 0 (အပြည့်အဝဖောက်ထွင်းမြင်ရသော) မှ 255 (အလင်းပိတ်သော) အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် alpha အစိတ်အပိုင်း
ဥပမာများ	color_hsva(40,100,100,200) → ‘255,170,0,200’

13.2.3.8. color_mix_rgb

ပေးထားသော အချိုး တစ်ခုအပေါ်အခြေခံ၍ အရောင်နှစ်ခု၏ အနီ (red)၊ အစိမ်း (green)၊ အပြာ (blue) နှင့် alpha (ဖောက်ထွင်းမြင်ရမှု) တန်ဖိုးများ ရောစပ်ထားသော အရောင်တစ်ခုကို ကိုယ်စားပြုသည့် string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_mix_rgb(color1, color2, ratio)
Argument များ	color1 - color string တစ်ခု color2 - color string တစ်ခု ratio - အချိုးတစ်ခု
ဥပမာများ	color_mix_rgb('0,0,0','255,255,255',0.5) → ‘127,127,127,255’

13.2.3.9. color_part

Color string တစ်ခုမှ သီးခြားအစိတ်အပိုင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်၊ ဥပမာ- အနီရောင်အစိတ်အပိုင်း သို့မဟုတ် alpha (ဖောက်ထွင်းမြင်ရသည့်) အစိတ်အပိုင်း။

Syntax (ဝါကျဖွဲ့ပုံ)	color_part(color, component)
Argument များ	color - color string တစ်ခု component - အရောင်အစိတ်အပိုင်းနှင့်သက်ဆိုင်သော ပြန်လည်ထုတ်ပေးမည့် string တစ်ခု။ ဆီလျော်မှုရှိသော ရွေးချယ်စရာများမှာ- red - RGB အနီရောင်အစိတ်အပိုင်း (0-255) green - RGB အစိမ်းရောင်အစိတ်အပိုင်း (0-255) blue - RGB အပြာရောင်အစိတ်အပိုင်း (0-255) alpha - alpha (ဖောက်ထွင်းမြင်ရမှု) တန်ဖိုး (0-255) hue - HSV hue (0-360) saturation - HSV saturation (0-100) value - HSV တန်ဖိုး (0-100) hsl_hue - HSL hue (0-360) hsl_saturation - HSL saturation (0-100) lightness - HSL lightness (0-100) cyan - CMYK စိမ်းပြာရောင်အစိတ်အပိုင်း (0-100) magenta - CMYK ပန်းခရမ်းရောင်အစိတ်အပိုင်း (0-100) yellow - CMYK အဝါရောင်အစိတ်အပိုင်း (0-100) black - CMYK အနက်ရောင်အစိတ်အပိုင်း (0-100)
ဥပမာများ	color_part('200,10,30','green') → 10

13.2.3.10. color_rgb

အရောင်တစ်ခု၏ red (အနီ) ၊ green (အစိမ်း)နှင့် blue (အပြာ) အစိတ်အပိုင်းများ အပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_rgb(red, green, blue)
Argument များ	red - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အနီရောင် အစိတ်အပိုင်း green - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အစိမ်းရောင် အစိတ်အပိုင်း blue - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အပြာရောင် အစိတ်အပိုင်း
ဥပမာများ	color_rgb(255,127,0) → ‘255,127,0’

13.2.3.11. color_rgba

အရောင်တစ်ခု၏ red (အနီ) ၊ green (အစိမ်း) ၊ blue (အပြာ) နှင့် alpha (ဖောက်ထွင်းမြင်ရမှု) အစိတ်အပိုင်းများ အပေါ် အခြေခံထားသော ၎င်းအရောင်၏ string representation (စာသားကိုယ်စားပြုမှု) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	color_rgba(red, green, blue, alpha)
Argument များ	red - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အနီရောင် အစိတ်အပိုင်း green - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အစိမ်းရောင် အစိတ်အပိုင်း blue - 0 မှ 255 အထိ ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် အပြာရောင် အစိတ်အပိုင်း alpha - 0 (အပြည့်အဝဖောက်ထွင်းမြင်ရသော) မှ 255 (အလင်းပိတ်သော) ရှိသော ကိန်းပြည့်တန်ဖိုးတစ်ခုအဖြစ် alpha အစိတ်အပိုင်း
ဥပမာများ	color_rgba(255,127,0,200) → ‘255,127,0,200’

13.2.3.12. create_ramp

Color string များနှင့် အဆင့်များ (steps) ၏ ဖော်ပြမှု (map) တစ်ခုမှ gradient ramp (အဆင့်ဆင့်သွားသောရောင်စဉ်တန်း) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	create_ramp(map, [discrete=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	map - color string များနှင့် အဆင့်များ၏ ဖော်ပြမှု (map) တစ်ခု discrete - discrete color ramp (တစ်ရောင်ချင်းစီဖြစ်သော ရောင်စဉ်တန်း) တစ်ခုကို ဖန်တီးရန် ဤသတ်မှတ်ချက်ကို true သို့ သတ်မှတ်ပါ။
ဥပမာများ	ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) → ‘255,0,0,255’

13.2.3.13. darker

ပို၍မှောင်သော (သို့မဟုတ် ပို၍လင်းသော) color string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	darker(color, factor)
Argument များ	color - color string တစ်ခု factor - မှောင်စေသည့် (darkening) factor နှင့် သက်ဆိုင်သော ကိန်းပြည့်တစ်ခု- အကယ်၍ factor သည် 100 ထက်ကြီးပါက ဤ လုပ်ဆောင်ချက် (function) သည် ပို၍မှောင်သည့်အရောင်ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည် (ဥပမာ- factor ကို 200 သို့ သတ်မှတ်ခြင်းသည် brightness (တောက်ပမှု) တစ်ဝက်ရှိသော အရောင်ကို ပြန်လည်ရရှိစေမည်ဖြစ်ပါသည်)၊ အကယ်၍ factor သည် 100 အောက်ငယ်ပါက ရရှိလာမည့် အရောင်သည် lighter (ပို၍လင်းသွားမည်) ဖြစ်မည်ဖြစ်ပါသည်။ သို့သော် ဤရည်ရွယ်ချက်အတွက် lighter() function ကို အသုံးပြုခြင်းအား အကြံပြုပါသည်၊ အကယ်၍ factor သည် 0 သို့မဟုတ် အနုတ် ဖြစ်ပါက ရရှိလာမည့် တန်ဖိုးသည် သတ်မှတ်ထားခြင်းရှိမည်မဟုတ်ပါ။
ဥပမာများ	darker('200,10,30', 200) → ‘100,5,15,255’

ထပ်မံဖတ်ရှုရန်- lighter

13.2.3.14. lighter

ပို၍လင်းသော (သို့မဟုတ် ပို၍မှောင်သော) color string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	lighter(color, factor)
Argument များ	color - color string တစ်ခု factor - လင်းစေသည့် (lightening) factor နှင့် သက်ဆိုင်သော ကိန်းပြည့်တစ်ခု- အကယ်၍ factor သည် 100 ထက်ကြီးပါက ဤ လုပ်ဆောင်ချက် (function) သည် ပို၍ လင်းသည့်အရောင်ကို ရရှိစေမည်ဖြစ်ပါသည် (ဥပမာ- factor ကို 150 သို့ သတ်မှတ်ခြင်းသည် 50% ရာခိုင်နှုန်း ပို၍လင်းသောအရောင်ကို ပြန်လည်ရရှိစေမည်ဖြစ်ပါသည်)၊ အကယ်၍ factor သည် 100 အောက်ငယ်ပါက ရရှိလာမည့် အရောင်သည် darker (ပို၍မှောင်သွားမည်) ဖြစ်မည်ဖြစ်ပါသည်။ သို့သော် ဤ ရည်ရွယ်ချက်အတွက် darker() function အသုံးပြုခြင်းကို အကြံပြုပါသည်။ အကယ်၍ factor သည် 0 သို့မဟုတ် အနုတ် ဖြစ်ပါက ရရှိလာမည့် တန်ဖိုးသည် သတ်မှတ်ထားခြင်းရှိမည်မဟုတ်ပါ။
ဥပမာများ	lighter('200,10,30', 200) → ‘255,158,168,255’

ထပ်မံဖတ်ရှုရန်- darker

13.2.3.15. project_color

Project ၏ အရောင်စီစဉ်ထားရှိမှု (color scheme) မှ အရောင်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	project_color(name)
Argument များ	name - အရောင်အမည်တစ်ခု
ဥပမာများ	project_color('Logo color') → ‘20,140,50’

ထပ်မံဖတ်ရှုရန်- Setting project colors (Project အရောင်များ setting လုပ်ခြင်း)

13.2.3.16. ramp_color

Color ramp (ရောင်စဉ်တန်း) တစ်ခုမှ အရောင်တစ်ခုကို ကိုယ်စားပြုဖော်ပြသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Saved ramp variant (သိမ်းဆည်းထားသော ramp မူကွဲ)

သိမ်းဆည်းထားသော ramp တစ်ခုမှ အရောင်တစ်ခုကို ကိုယ်စားပြုဖော်ပြသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	ramp_color(ramp_name, value)
Argument များ	ramp_name - string တစ်ခုအနေဖြင့် color ramp ၏ အမည်။ ဥပမာ- ‘Spectral’ (သက်တံ့ရောင် ရောင်စဉ်တန်း) value - 0 နှင့် 1 အကြား ကိန်းစစ် (real number) တစ်ခုအဖြစ် အရောင်ကိုရွေးချယ်ရန် ramp အပေါ်ရှိ တည်နေရာ (position)
ဥပမာများ	ramp_color('Spectral',0.3) → ‘253,190,115,255’

Note

ရရှိနိုင်သော color ramp များသည် QGIS ထည့်သွင်းမှု (installation) များအကြား ပြောင်းလဲနိုင်ပါသည်။ QGIS project ကို ထည့်သွင်းမှု (installation) တစ်ခုမှတစ်ခုသို့ ရွှေ့ပြောင်းသောအခါ ဤ function သည် မျှော်လင့်ထားသလို ရလာဒ်များ မထုတ်ပေးသည်များ ရှိနိုင်ပါသည်။

Expression-created ramp variant (Expression ဖြင့်ဖန်တီးထားသော ramp မူကွဲ)

Expression ဖြင့်ဖန်တီးထားသော ramp တစ်ခုမှ အရောင်တစ်ခုကို ကိုယ်စားပြုဖော်ပြသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	ramp_color(ramp, value)
Argument များ	ramp - color ramp value - 0 နှင့် 1 အကြား ကိန်းစစ် (real number) တစ်ခုအဖြစ် အရောင်ကိုရွေးချယ်ရန် ramp အပေါ်ရှိ တည်နေရာ (position)
ဥပမာများ	ramp_color(create_ramp(map(0,'0,0,0',1,'255,0,0')),1) → ‘255,0,0,255’

နောက်ထပ်ဖတ်ရှုရန်: ရောင်စဉ်တွဲ တစ်ခုပြုလုပ်ခြင်း (Setting a Color Ramp) (ရောင်စဉ်တန်းတစ်ခု setting လုပ်ခြင်း) ၊ အရောင်တွဲ သို့ဖြတ်လမ်းနည်း (The color ramp drop-down shortcut) (ရောင်စဉ်တန်း ရွေးချယ်စရာ shortcut)

13.2.3.17. set_color_part

Color string တစ်ခုအတွက် သီးသန့် အရောင် အစိတ်အပိုင်း (component) တစ်ခုကို သတ်မှတ်ပေးသည်။ ဥပမာ- အနီရောင်အစိတ်အပိုင်း သို့မဟုတ် alpha (ဖောက်ထွင်းမြင်ရသည့်) အစိတ်အပိုင်း

Syntax (ဝါကျဖွဲ့ပုံ)	set_color_part(color, component, value)
Argument များ	color - color string တစ်ခု component - သတ်မှတ်ရန် အရောင်အစိတ်အပိုင်းနှင့်သက်ဆိုင်သော string တစ်ခု။ ဆီလျော်မှုရှိသော ရွေးချယ်စရာများမှာ- red - RGB အနီရောင်အစိတ်အပိုင်း (0-255) green - RGB အစိမ်းရောင်အစိတ်အပိုင်း (0-255) blue - RGB အပြာရောင်အစိတ်အပိုင်း (0-255) alpha - alpha (ဖောက်ထွင်းမြင်ရမှု) တန်ဖိုး (0-255) hue - HSV hue (0-360) saturation - HSV saturation (0-100) value - HSV တန်ဖိုး (0-100) hsl_hue - HSL hue (0-360) hsl_saturation - HSL saturation (0-100) lightness - HSL lightness (0-100) cyan - CMYK စိမ်းပြာရောင်အစိတ်အပိုင်း (0-100) magenta - CMYK ပန်းခရမ်းရောင်အစိတ်အပိုင်း (0-100) yellow - CMYK အဝါရောင်အစိတ်အပိုင်း (0-100) black - CMYK အနက်ရောင်အစိတ်အပိုင်း (0-100) value - အရောင်အစိတ်အပိုင်းအတွက် အထက်ဖော်ပြပါစာရင်းများထဲမှ အပိုင်းအခြားများနှင့် စပ်လျဉ်းသော တန်ဖိုးအသစ်
ဥပမာများ	set_color_part('200,10,30','green',50) → ‘200,50,30,255’

13.2.4. Conditional Function များ

ဤအုပ်စုတွင် expression (စေခိုင်းချက်) များထဲတွင် အခြေအနေအရ (conditional) စစ်ဆေးမှုများကို ကိုင်တွယ်ရန် function များ ပါဝင်ပါသည်။

13.2.4.1. CASE

အခြေအနေများစွာ (series of condition) ကို အကဲဖြတ်ရန် CASE ကို အသုံးပြုပြီး ပထမဆုံး ကိုက်ညီသည့် အခြေအနေ(condition) အတွက် ရလာဒ်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အခြေအနေများကို အစဉ်လိုက်အားဖြင့် (sequentially) အကဲဖြတ်မည်ဖြစ်ပြီး အကယ်၍ အခြေအနေတစ်ခုသည် မှန်ကန်မှု (true) ရှိပါက အကဲဖြတ်ခြင်းသည် ရပ်သွားမည်ဖြစ်ပြီး သက်ဆိုင်ရာ ရလာဒ်ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ အကယ်၍ မည်သည့် အခြေအနေများမဆိုသည် မှန်ကန်မှု (true) မရှိပါက ELSE clause ထဲရှိ တန်ဖိုးကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ ထို့အပြင် ELSE clause ကို သတ်မှတ်ထားခြင်းမရှိပဲ မည်သည့် အခြေအနေများမဆိုသည် ကိုက်ညီခြင်း မရှိပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

CASE

WHEN condition THEN result

[ …n ]

[ ELSE result ]

END

[ ] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) အစိတ်အပိုင်းများဖြစ်ပါသည်

Argument များ

WHEN condition - အကဲဖြတ်ရန် အခြေအနေဆိုင်ရာဖော်ပြချက် (condition expression) တစ်ခု THEN result - အကယ်၍ condition (အခြေအနေ) သည် True (မှန်ကန်မှု) ဟု အကဲဖြတ်ပါက result(ရလာဒ်) ကို အကဲဖြတ်ပြီး ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ ELSE result - အကယ်၍ အထက်ဖော်ပြပါ မည်သည့် အခြေအနေများမဆိုသည် True (မှန်ကန်မှု) ဟု အကဲဖြတ်ခြင်းမခံရပါက result(ရလာဒ်) ကို အကဲဖြတ်ပြီး ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

ဥပမာများ

CASE WHEN "name" IS NULL THEN 'None' END → အကယ်၍ “name” field သည် NULL ဖြစ်ပါက ‘None’ ဆိုသည့် string ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ CASE WHEN $area > 10000 THEN 'Big property' WHEN $area > 5000 THEN 'Medium property' ELSE 'Small property' END → အကယ်၍ ဧရိယာသည် 10000 ထက်ကြီးပါက ‘Big property’ ဆိုသည့် string ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ အကယ်၍ ဧရိယာသည် 5000 နှင့် 10000 ကြားဖြစ်ပါက ‘Medium property’ ဆိုသည့် string ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး အခြားသောဧရိယာများအတွက်မူ ‘Small property’ ဆိုသည့် string ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

13.2.4.2. coalesce

Expression စာရင်းထဲမှ ပထမဆုံး NULL မဟုတ်သည့် တန်ဖိုး (non-NULL value) ကို ပြန်ထုတ်ပေးပါသည်။

ဤ function သည် Argument များ၏ မည်သည့် ကိန်းဂဏန်းကိုမဆို ရယူနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	coalesce(expression1, expression2, …)
Argument များ	expression - အမျိုးအစားနှင့်မသက်ဆိုင်ဘဲ ကျိုးကြောင်းဆီလျော်သည့် မည်သည့် expression သို့မဟုတ် တန်ဖိုးမဆို
ဥပမာများ	coalesce(NULL, 2) → 2 coalesce(NULL, 2, 3) → 2 coalesce(7, NULL, 3*2) → 7 coalesce("fieldA", "fallbackField", 'ERROR') → non-NULL ဖြစ်လျှင် fieldA ၏ တန်ဖိုး ထိုသို့မဟုတ်ပါက “fallbackField” ၏ တန်ဖိုး သို့မဟုတ် အကယ်၍ နှစ်ခုလုံးသည် NULL ဖြစ်ပါက ‘ERROR’ ဆိုသည့် string

13.2.4.3. if

အခြေအနေတစ်ခုကို စမ်းသပ်ပြီး အခြေအနေဆိုင်ရာစစ်ဆေးမှုများ (conditional check) အပေါ်မူတည်ပြီး မတူကွဲပြားသည့် ရလာဒ်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	if(condition, result_when_true, result_when_false)
Argument များ	condition - စစ်ဆေးမှုများ ပြုလုပ်သင့်သည့် အခြေအနေ result_when_true - အခြေအနေသည် true (မှန်ကန်မှု) ဖြစ်သည့်အခါတွင် သို့မဟုတ် အခြားသောတန်ဖိုးသည် false (မှန်ကန်မှုမရှိ) ဟု မပြောင်းလဲသည့်အခါတွင် ပြန်လည်ရရှိလာမည့် ရလာဒ် result_when_false - အခြေအနေသည် false (မှန်ကန်မှုမရှိ) ဖြစ်သည့်အခါတွင် သို့မဟုတ် အခြားသောတန်ဖိုးသည် 0 သို့မဟုတ် ‘’ ကဲ့သို့သော false (မှန်ကန်မှုမရှိ) အဖြစ်သို့ ပြောင်းလဲသည့်အခါတွင် ပြန်လည်ရရှိလာမည့် ရလာဒ်။ NULL ကိုလည်း false (မှန်ကန်မှုမရှိ) အဖြစ်သို့ ပြောင်းလဲမည်ဖြစ်ပါသည်။
ဥပမာများ	if( 1+1=2, 'Yes', 'No' ) → ‘Yes’ if( 1+1=3, 'Yes', 'No' ) → ‘No’ if( 5 > 3, 1, 0) → 1 if( '', 'It is true (not empty)', 'It is false (empty)' ) → ‘It is false (empty)’ if( ' ', 'It is true (not empty)', 'It is false (empty)' ) → ‘It is true (not empty)’ if( 0, 'One', 'Zero' ) → ‘Zero’ if( 10, 'One', 'Zero' ) → ‘One’

13.2.4.4. nullif

အကယ်၍ value1 သည် value2 တူညီပါက NULL တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ ထိုသို့မဟုတ်ပါက value1 ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ ၎င်းကို တန်ဖိုးများအား အခြေအနေအရ NULL ဖြင့် အစားထိုးရန် အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	nullif(value1, value2)
Argument များ	value1 - အသုံးပြုသင့်သော သို့မဟုတ် NULL ဖြင့် အစားထိုးသင့်သည့် တန်ဖိုး။ value2 - NULL substitution (အစားထိုးမှု) ကို စတင်ဆောင်ရွက်ပေးမည့် ထိန်းချုပ်တန်ဖိုး(control value)
ဥပမာများ	nullif('(none)', '(none)') → NULL nullif('text', '(none)') → ‘text’ nullif("name", '') → အကယ်၍ name သည် empty string (ဗလာစာသား) (သို့မဟုတ် NULL ဖြစ်ပြီးသား) တစ်ခုဖြစ်ပါက NULL ပြန်ထုတ်ပေးပါမည်။ အခြားမည်သည့်အတွက်မဆိုဖြစ်လျှင် name ကိုပြန်ထုတ်ပေးပါမည်။

13.2.4.5. regexp_match

Unicode string (ယူနီကုဒ်စာသား) တစ်ခုအတွင်းရှိ ပုံမှန် (regular) expression တစ်ခုနှင့်ကိုက်ညီမှုရှိသော ပထမဆုံးကိုက်ညီမှုရှိသည့်တည်နေရာ (first matching position) ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး သို့မဟုတ် substring ကို မတွေ့ရှိပါက 0 ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	regexp_match(input_string, regex)
Argument များ	input_string - ပုံမှန် expression တစ်ခုအတိုင်း စမ်းသပ်မည့် string regex - စမ်းသပ်ရန် regular expression။ Backslash သင်္ကေတ () များသည် double escaped ဖြစ်ရမည်ဖြစ်ပါသည် (ဥပမာ- အဖြူရောင် space character တစ်ခုနှင့်ကိုက်ညီစေရန် “\\s” သို့မဟုတ် စာလုံး boundary တစ်ခုနှင့်ကိုက်ညီစေရန် “\\b”)
ဥပမာများ	regexp_match('QGIS ROCKS','\\sROCKS') → 5 regexp_match('Budač','udač\\b') → 2

13.2.4.6. try

Expression တစ်ခုကို စမ်းသပ်ပြီး အကယ်၍ error-free (အမှားကင်းခြင်း) ဖြစ်ပါက ၎င်း၏တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ expression သည် error တစ်ခုကို ထုတ်ပေးလျှင် ပံ့ပိုးပေးထားသော အခြားသောတန်ဖိုး (alternative value) တစ်ခုကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး ထိုသို့မဟုတ်ပါက function သည် NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	try(expression, [alternative]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	expression - လုပ်ဆောင် (run) သင့်သည့် expression alternative - အကယ်၍ expression သည် error တစ်ခုကို ရရှိပါက ပြန်လည်ရရှိလာမည့် ရလဒ်
ဥပမာများ	try( to_int( '1' ), 0 ) → 1 try( to_int( 'a' ), 0 ) → 0 try( to_date( 'invalid_date' ) ) → NULL

13.2.5. ‌‌ဒေတာအမျိုးအစားပြောင်း Function များ (Conversions Functions)

ဤအုပ်စုတွင် data အမျိုးအစားတစ်ခုမှ အခြားတစ်ခုကို ပြောင်းရန် function များ ပါဝင်ပါသည်။ (ဥပမာ- string (စာသား) မှ/သို့ integer (ကိန်းပြည့်) ၊ binary (အ‌ခြေအနေနှစ်ခုသာရှိသည့် data) မှ/သို့ string ၊ string မှ date (နေ့စွဲသို့)၊ …)။

13.2.5.1. from_base64

Base64 encoding ထဲရှိ string တစ်ခုအား binary တန်ဖိုးတစ်ခုအဖြစ်သို့ decode (code တစ်ခုအား နားလည်နိုင်သည့် ဘာသာစကားအဖြစ်သို့ပြောင်းလဲခြင်း) ပြုလုပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	from_base64(string)
Argument များ	string - decode ပြုလုပ်ရန် string
ဥပမာများ	from_base64('UUdJUw==') → ‘QGIS’

13.2.5.2. hash

ပေးထားသည့် နည်းလမ်းတစ်ခုဖြင့် string တစ်ခုမှ hash တစ်ခုကို ဖန်တီးပေးပါသည်။ byte (8 bits) တစ်ခုကို hex ‘’digits’’ နှစ်ခုဖြင့် ကိုယ်စားပြုဖော်ပြပါသည်။ ထို့အတွက်ကြောင့် ‘md4’ (16 bytes) သည် 16 * 2 = 32 character ရှည်လျားသည့် hex string တစ်ခုကို ထုတ်ပေးပြီး ‘keccak_512’ (64 bytes) သည် 64 * 2 = 128 character ရှည်လျားသည့် hex string ကို ထုတ်လုပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hash(string, method)
Argument များ	string - hash ပြုလုပ်ရန် string method - ‘md4’၊ ‘md5’၊ ‘sha1’၊ ‘sha224’၊ ‘sha384’၊ ‘sha512’၊ ‘sha3_224’၊’sha3_256’၊ ‘sha3_384’၊ ‘sha3_512’၊ ‘keccak_224’၊ ‘keccak_256’၊ ‘keccak_384’၊ ‘keccak_512’ များအကြားရှိ hash နည်းလမ်း
ဥပမာများ	hash('QGIS', 'md4') → ‘c0fc71c241cdebb6e888cbac0e2b68eb’ hash('QGIS', 'md5') → ‘57470aaa9e22adaefac7f5f342f1c6da’ hash('QGIS', 'sha1') → ‘f87cfb2b74cdd5867db913237024e7001e62b114’ hash('QGIS', 'sha224') → ‘4093a619ada631c770f44bc643ead18fb393b93d6a6af1861fcfece0’ hash('QGIS', 'sha256') → ‘eb045cba7a797aaa06ac58830846e40c8e8c780bc0676d3393605fae50c05309’ hash('QGIS', 'sha384') → ‘91c1de038cc3d09fdd512e99f9dd9922efadc39ed21d3922e69a4305cc25506033aee388e554b78714c8734f9cd7e610’ hash('QGIS', 'sha512') → ‘c2c092f2ab743bf8edbeb6d028a745f30fc720408465ed369421f0a4e20fa5e27f0c90ad72d3f1d836eaa5d25cd39897d4cf77e19984668ef58da6e3159f18ac’ hash('QGIS', 'sha3_224') → ‘467f49a5039e7280d5d42fd433e80d203439e338eaabd701f0d6c17d’ hash('QGIS', 'sha3_256') → ‘540f7354b6b8a6e735f2845250f15f4f3ba4f666c55574d9e9354575de0e980f’ hash('QGIS', 'sha3_384') → ‘96052da1e77679e9a65f60d7ead961b287977823144786386eb43647b0901fd8516fa6f1b9d243fb3f28775e6dde6107’ hash('QGIS', 'sha3_512') → ‘900d079dc69761da113980253aa8ac0414a8bd6d09879a916228f8743707c4758051c98445d6b8945ec854ff90655005e02aceb0a2ffc6a0ebf818745d665349’ hash('QGIS', 'keccak_224') → ‘5b0ce6acef8b0a121d4ac4f3eaa8503c799ad4e26a3392d1fb201478’ hash('QGIS', 'keccak_256') → ‘991c520aa6815392de24087f61b2ae0fd56abbfeee4a8ca019c1011d327c577e’ hash('QGIS', 'keccak_384') → ‘c57a3aed9d856fa04e5eeee9b62b6e027cca81ba574116d3cc1f0d48a1ef9e5886ff463ea8d0fac772ee473bf92f810d’

13.2.5.3. md5

String တစ်ခုမှ md5 hash တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	md5(string)
Argument များ	string - hash ပြုလုပ်ရန် string
ဥပမာများ	md5('QGIS') → ‘57470aaa9e22adaefac7f5f342f1c6da’

13.2.5.4. sha256

String တစ်ခုမှ sha256 hash တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sha256(string)
Argument များ	string - hash ပြုလုပ်ရန် string
ဥပမာများ	sha256('QGIS') → ‘eb045cba7a797aaa06ac58830846e40c8e8c780bc0676d3393605fae50c05309’

13.2.5.5. to_base64

Base64 encoding ကို အသုံးပြုပြီး binary တန်ဖိုးတစ်ခုကို string တစ်ခုအဖြစ်သို့ encode ပြုလုပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_base64(value)
Argument များ	value - encode ပြုလုပ်ရန် binary တန်ဖိုး
ဥပမာများ	to_base64('QGIS') → ‘UUdJUw==’

13.2.5.6. to_date

String တစ်ခုကို နှစ်၊ လ၊ နေ့ရက်၊ နာရီ၊ မိနစ်၊ စက္ကန့် နှင့် မီလီစက္ကန့် စသည့် ရက်စွဲနှင့်သက်ဆိုင်သည့်အရာဝတ္ထု (date object) တစ်ခုအဖြစ်သို့ ပြောင်းလဲပေးပါသည်။ String ကို ခွဲခြမ်းစိတ်ဖြာရန် (parse) စိတ်ကြိုက်ရွေးချယ်ထားသည့် format string ကို အသုံးပြုနိုင်ပါသည်။ QDate::fromString သို့မဟုတ် format ဆိုင်ရာ ထပ်ဆောင်းစာရွက်စာတမ်းများအတွက် format_date function ၏ documentation ကို ကြည့်ရှုပါ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_date(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ရက်စွဲတန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို ရက်စွဲတစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် format language - string ကို ရက်စွဲတစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် ဘာသာစကား (lowercase(စာလုံးအသေး)၊ two- or three-letter၊ ISO 639 language code)။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	to_date('2012-05-04') → 2012-05-04 to_date('June 29, 2019','MMMM d, yyyy') → အကယ်၍ လက်ရှိ locale သည် ၆လမြောက်အတွက် ‘June’(ဇွန်) ဆိုသည့် အမည်ကို အသုံးပြုပါလျှင် 2019-06-29 ဟုပြန်ထုတ်ပေးမည်ဖြစ်သည်၊ သို့မဟုတ်ပါက error တစ်ခုဖြစ်ပါမည်။ to_date('29 juin, 2019','d MMMM, yyyy','fr') → 2019-06-29

13.2.5.7. to_datetime

String တစ်ခုကို ပြက္ခဒိန်တစ်ခုရှိ ရက်စွဲ (နှစ်၊ လနှင့် နေ့) ကို ကိုယ်စားပြုသည့် (datetime object) တစ်ခုအဖြစ်သို့ ပြောင်းပေးပါသည်။ String ကိုခွဲခြမ်းစိတ်ဖြာရန် (parse) စိတ်ကြိုက်ရွေးချယ်ထားသည့် format string ကို အသုံးပြုနိုင်ပါသည်။ QDate::fromString ၊ QTime::fromString သို့မဟုတ် format ဆိုင်ရာ ထပ်ဆောင်းစာရွက်စာတမ်းများအတွက် format_date function ၏ documentation ကို ကြည့်ရှုပါ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_datetime(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ရက်စွဲအချိန် (datatime) တန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို ရက်စွဲအချိန် (datatime) တစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် format language - string ကို ရက်စွဲအချိန် (datatime) တစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် ဘာသာစကား (lowercase(စာလုံးအသေး)၊ two- or three-letter၊ ISO 639 language code)။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	to_datetime('2012-05-04 12:50:00') → 2012-05-04T12:50:00 to_datetime('June 29, 2019 @ 12:34','MMMM d, yyyy @ HH:mm') → အကယ်၍ လက်ရှိ locale သည် ၆လမြောက်အတွက် ‘June’(ဇွန်) ဆိုသည့် အမည်ကို အသုံးပြုပါလျှင် 2019-06-29T12:34 ဟုပြန်ထုတ်ပေးမည်ဖြစ်သည်၊ သို့မဟုတ်ပါက error တစ်ခုဖြစ်ပါမည်။ to_datetime('29 juin, 2019 @ 12:34','d MMMM, yyyy @ HH:mm','fr') → 2019-06-29T12:34

13.2.5.8. to_decimal

Degree (ဒီဂရီ)၊ minute (မိနစ်)၊ second (စက္ကန့်) ကိုဩဒိနိတ်ကို ၎င်းနှင့်တူညီသည့် ဒဿမကိန်း (decimal) အဖြစ်သို့ ပြောင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_decimal(value)
Argument များ	value - degree (ဒီဂရီ)၊ minute (မိနစ်)၊ second (စက္ကန့်) string တစ်ခု
ဥပမာများ	to_decimal('6°21\'16.445') → 6.3545680555

13.2.5.9. to_dm

ကိုဩဒိနိတ် (coordinate) တစ်ခုကို degree (ဒီဂရီ)၊ minute (မိနစ်) သို့ ပြောင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_dm(coordinate, axis, precision, [formatting=]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	coordinate - လတ္တီကျု သို့မဟုတ် လောင်ဂျီကျု တန်ဖိုးတစ်ခု axis - ကိုဩဒိနိတ် (coordinate) ၏ ဝင်ရိုး (axis)။ ‘x’ သို့မဟုတ် ‘y’ precision - ဒဿမကိန်းအရေအတွက် formatting - format အမျိုးအစားကို သတ်မှတ်ပေးသည်။ လက်ခံနိုင်သည့်တန်ဖိုးများမှာ NULL(default)၊ ‘aligned’ သို့မဟုတ် ‘suffix’ ။
ဥပမာများ	to_dm(6.1545681, 'x', 3) → 6°9.274′ to_dm(6.1545681, 'y', 4, 'aligned') → 6°09.2741′N to_dm(6.1545681, 'y', 4, 'suffix') → 6°9.2741′N

13.2.5.10. to_dms

ကိုဩဒိနိတ် (coordinate) တစ်ခုကို degree (ဒီဂရီ)၊ minute (မိနစ်)၊ second (စက္ကန့်) သို့ ပြောင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_dms(coordinate, axis, precision, [formatting=]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	coordinate - လတ္တီကျု သို့မဟုတ် လောင်ဂျီကျု တန်ဖိုးတစ်ခု axis - ကိုဩဒိနိတ် (coordinate) ၏ ဝင်ရိုး (axis)။ ‘x’ သို့မဟုတ် ‘y’ precision - ဒဿမကိန်းအရေအတွက် formatting - format အမျိုးအစားကို သတ်မှတ်ပေးသည်။ လက်ခံနိုင်သည့်တန်ဖိုးများမှာ NULL(default)၊ ‘aligned’ သို့မဟုတ် ‘suffix’ ။
ဥပမာများ	to_dms(6.1545681, 'x', 3) → 6°9′16.445″ to_dms(6.1545681, 'y', 4, 'aligned') → 6°09′16.4452″N to_dms(6.1545681, 'y', 4, 'suffix') → 6°9′16.4452″N

13.2.5.11. to_int

String တစ်ခုကို ကိန်းပြည့်ဂဏန်း (integer number) အဖြစ်သို့ပြောင်းပေးပါသည်။ အကယ်၍ တန်ဖိုးတစ်ခုသည် integer (ကိန်းပြည့်) အဖြစ်သို့ ပြောင်းလဲနိုင်ခြင်းမရှိပါက မည်သည်ကိုမျှ ပြန်ထုတ်ပေးမည်မဟုတ်ပါ (ဥပမာ- ‘123asd’ သည် ဆီလျော်မှုမရှိပါ)။

Syntax (ဝါကျဖွဲ့ပုံ)	to_int(string)
Argument များ	string - ကိန်းပြည့်ဂဏန်း (integer number) အဖြစ်သို့ပြောင်းပေးမည့် string
ဥပမာများ	to_int('123') → 123

13.2.5.12. to_interval

String တစ်ခုကို interval (အချိန်နှစ်ခုအကြားအပိုင်းအခြား) အမျိုးအစားအဖြစ်သို့ ပြောင်းပေးပါသည်။ ရက်စွဲ တစ်ခု၏ ရက်၊ နာရီ၊ လ၊ စသည်တို့ကို ရယူရာတွင် အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_interval(string)
Argument များ	string - interval တစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု။ ခွင့်ပြုထားသည့် format များတွင် {n} နေ့ရက်များ {n} နာရီများ {n} လများ ပါဝင်ပါသည်။
ဥပမာများ	to_interval('1 day 2 hours') → interval: 1.08333 days to_interval( '0.5 hours' ) → interval: 30 minutes to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

13.2.5.13. to_real

String တစ်ခုကို ကိန်းစစ် (real number) တစ်ခု အဖြစ်သို့ ပြောင်းပေးပါသည်။ အကယ်၍ တန်ဖိုးတစ်ခုသည် ကိန်းစစ်များအဖြစ်သို့ ပြောင်းလဲနိုင်ခြင်းမရှိပါက မည်သည်ကိုမျှ ပြန်ထုတ်ပေးမည်မဟုတ်ပါ (ဥပမာ- ‘123.56asd’ သည် ဆီလျော်မှုမရှိပါ)။ အကယ်၍ တိကျမှု (precision) သည် ပြောင်းလဲမှုရလာဒ်အောက်ငယ်ပါက ပြောင်းလဲမှုများကို သိမ်းဆည်းပြီးနောက်တွင် ဂဏန်းများကို အနီးစပ်ဆုံးယူ (round) ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_real(string)
Argument များ	string - ကိန်းစစ်တစ်ခုအဖြစ်သို့ ပြောင်းလဲရန် string
ဥပမာများ	to_real('123.45') → 123.45

13.2.5.14. to_string

ဂဏန်းနံပါတ်တစ်ခုကို string အဖြစ်သို့ ပြောင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_string(number)
Argument များ	number - ကိန်းပြည့် သို့မဟုတ် ကိန်းစစ်တန်ဖိုး။ String သို့ ပြောင်းလဲရန် နံပါတ်။
ဥပမာများ	to_string(123) → ‘123’

13.2.5.15. to_time

String တစ်ခုကို အချိန်နှင့်သက်ဆိုင်သည့်အရာဝတ္ထု (time object) တစ်ခုအဖြစ်သို့ ပြောင်းပေးပါသည်။ String ကိုခွဲခြမ်းစိတ်ဖြာရန် (parse) စိတ်ကြိုက်ရွေးချယ်ထားသည့် format string ကို အသုံးပြုနိုင်ပါသည်။ Format ဆိုင်ရာ ထပ်ဆောင်း စာရွက်စာတမ်း အတွက် QTime::fromString ကို ကြည့်ရှုပါ

Syntax (ဝါကျဖွဲ့ပုံ)	to_time(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - အချိန်တန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို အချိန်တစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် format language - string ကို အချိန်တစ်ခုအဖြစ် ပြောင်းရန် အသုံးပြုသည့် ဘာသာစကား (စာလုံးအသေး၊ two- or three-letter၊ ISO 639 language code)
ဥပမာများ	to_time('12:30:01') → 12:30:01 to_time('12:34','HH:mm') → 12:34:00 to_time('12:34','HH:mm','fr') → 12:34:00

13.2.6. ကိုယ်တိုင်ရေး Function များ (Custom Functions)

ဤအုပ်စုတွင် အသုံးပြုသူမှ ဖန်တီးထားသော function များ ပါဝင်ပါသည်။ နောက်ထပ်အသေးစိတ်အချက်အလက်များအတွက် Function ပြင်ဆင်ရာ (Function Editor) တွင်ကြည့်ရှုပါ။

13.2.7. ရက်စွဲနှင့်အချိန် Function များ (Date and Time Functions)

ဤအုပ်စုတွင် ရက်စွဲ နှင့် အချိန် data များကို ကိုင်တွယ်ရန်အတွက် function များ ပါဝင်ပါသည်။ ဤအုပ်စုတွင် ‌‌ဒေတာအမျိုးအစားပြောင်း Function များ (Conversions Functions) (to_date ၊ to_time ၊ to_datetime ၊ to_interval) နှင့် စာသား Function များ (String Functions) (format_date) အုပ်စုများဖြင့် function အများအပြားကို မျှဝေထားပါသည်။

Note

Field များပေါ်တွင် ရက်စွဲ၊ ရက်စွဲအချိန် နှင့် interval (ကြားကာလ) များကို သိုလှောင်ခြင်း

date (ရက်စွဲ) * ၊ *time (အချိန်) နှင့် datetime (ရက်စွဲအချိန်) တန်ဖိုးများကို field များပေါ်တွင် တိုက်ရိုက်သိမ်းဆည်းနိုင်မှုသည် data ရင်းမြစ် ပံ့ပိုးပေးသူအပေါ် မူတည်ပါသည်။ (ဥပမာ- Shapefile သည် date format ကိုလက်ခံသော်လည်း datetime သို့မဟုတ် time format များကို လက်မခံပါ)။ ဤကန့်သတ်ချက်ကို ကျော်လွှားရန် အကြံပြုချက်အချို့ကို အောက်တွင် ဖော်ပြထားပါသည်-

• format_date function ကို အသုံးပြုပြီး date ၊ datetime နှင့် time တို့ကို စာသားအမျိုးအစား field များတွင် ပြောင်းလဲ၍ သိမ်းဆည်းနိုင်ပါသည်။

• Intervals သည် ရက်စွဲထုတ်ယူခြင်း (data extraction) function များထဲမှ တစ်ခုကို အသုံးပြုပြီး ကိန်းပြည့် (integer) သို့မဟုတ် ဒသမကိန်းဂဏန်း (decimal) အမျိုးအစား field များတွင် သိမ်းဆည်းနိုင်ပါသည် (ဥပမာ- ရက်များဖြင့် ဖော်ပြထားသည့် interval ကို ရရှိရန် day()) ။

13.2.7.1. age

ရက်စွဲ (date) နှစ်ခု သို့မဟုတ် ရက်စွဲအချိန် (datetime) နှစ်ခု အကြားရှိ ကွာခြားချက် (difference) ကို ပြန်ထုတ်ပေးပါသည်။

ကွာခြားချက်ကို Interval (အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြား) တစ်ခုအဖြစ် ရရှိမည်ဖြစ်ပြီး အသုံးဝင်သည့် သတင်းအချက်အလက်များကို ထုတ်ယူရရှိနိုင်ရန် (extract) အတွက် အောက်ဖော်ပြပါ function (လုပ်ဆောင်ချက်များ) ထဲမှ တစ်ခုနှင့် တွဲ၍ အသုံးပြုရန်လိုအပ်ပါသည်-

• year (နှစ်)

• month (လ)

• week (ရက်သတ္တပတ်)

• day (ရက်စွဲ)

• hour (နာရီ)

• minute (မိနစ်)

• second (စက္ကန့်)

Syntax (ဝါကျဖွဲ့ပုံ)	age(datetime1, datetime2)
Argument များ	datetime1 - နောက်ပိုင်းရက်စွဲ (later date) ကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု၊ ရက်စွဲ (date) သို့မဟုတ် ရက်စွဲအချိန် (datetime) တစ်ခု datetime2 - ရှေ့ပိုင်းရက်စွဲ (earlier date) ကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု၊ ရက်စွဲ (date) သို့မဟုတ် ရက်စွဲအချိန် (datetime) တစ်ခု
ဥပမာများ	day(age('2012-05-12','2012-05-02')) → 10 hour(age('2012-05-12','2012-05-02')) → 240

13.2.7.2. datetime_from_epoch

1970-01-01T00:00:00,000 မှစ၍ ကျော်လွန်သွားသော ၎င်း၏ ရက်စွဲနှင့်အချိန်သည် မီလီစက္ကန့်များ(milliseconds) msecs ဖြစ်သည့် ရက်စွဲအချိန် (datetime) တစ်ခုကို Coordinated Universal Time (Qt.UTC) ဖြင့် ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး Qt.LocalTime (ဒေသစံတော်ချိန်နှင့်ရက်စွဲ) သို့ ပြောင်းလဲပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	datetime_from_epoch(int)
Argument များ	int - ကိန်းဂဏန်းများ (မီလီစက္ကန့်များ)
ဥပမာများ	datetime_from_epoch(1483225200000) → 2017-01-01T00:00:00

13.2.7.3. day

ရက်စွဲတစ်ခုမှ နေ့ရက် သို့မဟုတ် အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြား (interval) တစ်ခုမှ နေ့ရက် အရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Date variant (ရက်စွဲမူကွဲ)

ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန်တစ်ခုမှ နေ့ရက်ကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	day(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုးတစ်ခု
ဥပမာများ	day('2012-05-12') → 12

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြား (interval) တစ်ခု၏ ရှည်ကြာမှု (length) ကို နေ့ရက်များဖြင့် တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	day(interval)
Argument များ	interval - ရက်အရေအတွက်များကို ရရှိရန် အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြားတန်ဖိုး(interval value)
ဥပမာများ	day(to_interval('3 days')) → 3 day(to_interval('3 weeks 2 days')) → 23 day(age('2012-01-01','2010-01-01')) → 730

13.2.7.4. day_of_week

သတ်မှတ်ထားသည့် ရက်စွဲ သို့မဟုတ် အချိန်ရက်စွဲတစ်ခုအတွက် ရက်သတ္တပတ်၏ နေ့ရက်ကို ရရှိစေပါသည်။ ရရှိလာသည့်တန်ဖိုးသည် 0 မှ 6 အထိ အပိုင်းအခြားပမာဏဖြစ်ပြီး 0 သည် တနင်္ဂနွေနေ့နှင့် သက်ဆိုင်ပြီး 6 သည် စနေနေ့နှင့် သက်ဆိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	day_of_week(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုး
ဥပမာများ	day_of_week(to_date('2015-09-21')) → 1

13.2.7.5. epoch

Unix epoch (January 1st, 1970 at 00:00:00 UTC ကို Unix epoch အဖြစ်ရည်ညွှန်းပါသည်) နှင့် ပေးထားသည့် ရက်စွဲတန်ဖိုး အကြားရှိ အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) ကို မီလီစက္ကန့်များ(milliseconds) ဖြင့် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	epoch(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုးတစ်ခု
ဥပမာများ	epoch(to_date('2017-01-01')) → 1483203600000

13.2.7.6. format_date

ရက်စွဲအမျိုးအစား သို့မဟုတ် string တစ်ခုကို စိတ်ကြိုက်ရွေးချယ်ထားသည့် string format တစ်ခုအဖြစ်သို့ format ပြုလုပ်ပေးပါသည်။ Qt date/time format string များကို အသုံးပြုပါသည်။ QDateTime::toString ကို ကြည့်ရှုပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	format_date(datetime, format, [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	datetime - ရက်စွဲ၊ အချိန် သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုး format - string ကို format ပြုလုပ်ရန် အသုံးပြုသည့် String template (နမူနာပုံစံ) Expression Output (ရလာဒ်) d နေ့ရက်ကို ရှေ့မှ သုညဖြင့် မစတင်သည့် ဂဏန်းအဖြစ် (1 မှ 31 သို့) dd နေ့ရက်ကို ရှေ့မှ သုညဖြင့် စတင်သည့် ဂဏန်းအဖြစ် (01 မှ 31 သို့) ddd အတိုချုပ်ထားသည့် နေ့အမည် (ဥပမာ ‘Mon’ မှ ‘Sun’) dddd နေ့အမည် အပြည့်အစုံ (ဥပမာ ‘Monday’ မှ ‘Sunday’) M လကို ရှေ့မှ သုညဖြင့် မစတင်သည့် ဂဏန်းအဖြစ် (1-12) MM လကို ရှေ့မှ သုညဖြင့် စတင်သည့် ဂဏန်းအဖြစ် ဂဏန်းအဖြစ် (01-12)” MMM အတိုချုပ်ထားသည့် လအမည် (ဥပမာ ‘Jan’ မှ ‘Dec’) MMMM လအမည်အပြည့်အစုံ (ဥပမာ ‘January’ မှ ‘December’) yy ဒစ်ဂျယ်ဂဏန်း နှစ်လုံးအဖြစ် ခုနှစ် (00-99) yyyy ဒစ်ဂျယ်ဂဏန်း လေးလုံးအဖြစ် ခုနှစ် ဤ expression များကို format string ၏ အချိန်အစိတ်အပိုင်းအဖြစ် အသုံးပြုနိုင်ပါသည်- Expression Output (ရလာဒ်) h ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (0 မှ 23 သို့မဟုတ် အကယ်၍ AM/PM ပြသမှုဖြစ်ပါက 1 မှ 12) hh ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (00 မှ 23 သို့မဟုတ် အကယ်၍ AM/PM ပြသမှုဖြစ်ပါက 01 မှ 12) H ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (0 မှ 23 ၊ AM/PM ပြသမှု ဖြစ်စေကာမူ) HH ရှေ့မှ သုညဖြင့် စတင်သည့် နာရီ (00 မှ 23 ၊ AM/PM ပြသမှု ဖြစ်စေကာမူ) m ရှေ့မှ သုညဖြင့် မစတင်သည့် မိနစ် (0 မှ 59) mm ရှေ့မှ သုညဖြင့် စတင်သည့် မိနစ် (00 မှ 59) s ရှေ့မှ သုညဖြင့် မစတင်သည့် စက္ကန့် (0 မှ 59) ss ရှေ့မှ သုညဖြင့် စတင်သည့် စက္ကန့် (00 မှ 59) z trailing zeroes (ဒဿမနောက်ရှိ သုည) များ မပါရှိသည့် မီလီစက္ကန့်များ (0 မှ 999) zzz trailing zeroes (ဒဿမနောက်ရှိ သုည) များ ပါရှိသည့် မီလီစက္ကန့်များ (000 မှ 999) AP သို့မဟုတ် A AM/PM အချိန်တစ်ခုအဖြစ် ပြန်ဆိုပါသည်။ AP သည်’AM’ သို့မဟုတ် ‘PM’ တစ်ခုမဟုတ်တစ်ခု ဖြစ်ရပါမည် ap သို့မဟုတ် a AM/PM အချိန်တစ်ခုအဖြစ် ပြန်ဆိုပါသည်။ ap သည် ‘am’ သို့မဟုတ် ‘pm’ တစ်ခုမဟုတ်တစ်ခု ဖြစ်ရပါမည် language - ရက်စွဲကို စိတ်ကြိုက်ရွေးချယ်ထားသည့် string တစ်ခုအဖြစ်သို့ format ပြုလုပ်ရန် ဘာသာစကား (lowercase(စာလုံးအသေး) ၊ two- or three-letter၊ ISO 639 language code) ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	format_date('2012-05-15','dd.MM.yyyy') → ‘15.05.2012’ format_date('2012-05-15','d MMMM yyyy','fr') → ‘15 mai 2012’ format_date('2012-05-15','dddd') → အကယ်၍ လက်ရှိ locale သည် English မူကွဲ (variant) တစ်ခုဖြစ်ပါက ‘Tuesday’ ပြန်ထုတ်ပေးပါမည် format_date('2012-05-15 13:54:20','dd.MM.yy') → ‘15.05.12’ format_date('13:54:20','hh:mm AP') → ‘01:54 PM’

13.2.7.7. hour

ရက်စွဲအချိန် သို့မဟုတ် ရက်စွဲ တစ်ခုမှ နာရီအစိတ်အပိုင်း သို့မဟုတ် အပိုင်းအခြားကာလတစ်ခုမှ နာရီအရေအတွက် ကိုထုတ်ယူပေးပါသည်။

Time variant (အချိန်မူကွဲ)

အချိန် သို့မဟုတ် ရက်စွဲအချိန် တစ်ခုမှ နာရီအစိတ်အပိုင်းကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hour(datetime)
Argument များ	datetime - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန်တန်ဖိုးတစ်ခု
ဥပမာများ	hour( to_datetime('2012-07-22 13:24:57') ) → 13

Interval variant(အပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြား (interval) တစ်ခု၏ ရှည်ကြာမှုကို နာရီများဖြင့် တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hour(interval)
Argument များ	interval - နာရီအရေအတွက်ကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားရှိအပိုင်းအခြားတန်ဖိုး
ဥပမာများ	hour(to_interval('3 hours')) → 3 hour(age('2012-07-22T13:00:00','2012-07-22T10:00:00')) → 3 hour(age('2012-01-01','2010-01-01')) → 17520

13.2.7.8. make_date

ခုနှစ်၊ လ နှင့် နေ့ရက် အရေအတွက်များမှ ရက်စွဲတန်ဖိုး တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_date(year, month, day)
Argument များ	year - ခုနှစ် ဂဏန်း။ 1 မှ 99 အထိ ခုနှစ်များကို ထိုအတိုင်း အဓိပ္ပါယ်ဖွင့်ဆိုသည်။ ခုနှစ် 0 သည် invalid (ဆီလျော်မှုမရှိ) ဖြစ်ပါသည်။ month - လ ဂဏန်း၊ 1=January ဖြစ်ပါသည်။ day - နေ့ရက် ဂဏန်း၊ လ၏ ပထမဆုံးနေ့ရက်ကို 1 ဖြင့် စတင်ပါသည်။
ဥပမာများ	make_date(2020,5,4) → date value 2020-05-04

13.2.7.9. make_datetime

ခုနှစ်၊ လ၊ နေ့ရက်၊ နာရီ၊ မိနစ်နှင့် စက္ကန့် အရေအတွက်များ မှ ရက်စွဲအချိန် တန်ဖိုးတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_datetime(year, month, day, hour, minute, second)
Argument များ	year - နှစ် ဂဏန်း။ 1 မှ 99 အထိ နှစ်များကို ထိုအတိုင်းအဓိပ္ပါယ်ဖွင့်ဆိုသည်။ Year 0 သည် invalid (ဆီလျော်မှုမရှိ) ဖြစ်ပါသည်။ month - လ ဂဏန်း။ 1=January ဖြစ်ပါသည်။ day - ရက် ဂဏန်း၊ လ၏ ပထမဆုံးရက်အတွက် 1 ဖြင့် စတင်ပါသည်။ hour - နာရီ ဂဏန်း minute - မိနစ်များ second - စက္ကန့်များ (အပိုင်းကိန်းတန်ဖိုးများ (fractional values) တွင် မီလီစက္ကန့်များပါဝင်သည်)
ဥပမာများ	make_datetime(2020,5,4,13,45,30.5) → datetime value 2020-05-04 13:45:30.500

13.2.7.10. make_interval

ခုနှစ်၊ လ၊ ရက်သတ္တပတ်များ၊ နေ့ရက်များ၊ နာရီများ၊ မိနစ်နှင့် စက္ကန့် တန်ဖိုးများ မှ အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တန်ဖိုး တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_interval([years=0], [months=0], [weeks=0], [days=0], [hours=0], [minutes=0], [seconds=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	years - ခုနှစ်အရေအတွက်များ (နှစ်တစ်နှစ်၏ ကြာရှည်မှုမှာ 365.25 ရက် ဖြစ်သည်ဟု ယူဆပါသည်) months - လအရေအတွက်များ (လတစ်လ၏ ကြာရှည်မှုမှာ ရက် ၃၀ ဖြစ်သည်ဟု ယူဆပါသည်) weeks - ရက်သတ္တပတ်အရေအတွက်များ days - နေ့ရက်အရေအတွက်များ hours - နာရီအရေအတွက်များ minutes - မိနစ်အရေအတွက်များ seconds - စက္ကန့်အရေအတွက်များ
ဥပမာများ	make_interval(hours:=3) → interval: 3 hours make_interval(days:=2, hours:=3) → interval: 2.125 days make_interval(minutes:=0.5, seconds:=5) → interval: 35 seconds

13.2.7.11. make_time

နာရီ၊ မိနစ်နှင့် စက္ကန့် အရေအတွက်များမှ အချိန်တန်ဖိုးတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_time(hour, minute, second)
Argument များ	hour - နာရီ ဂဏန်း minute - မိနစ်များ second - စက္ကန့်များ (အပိုင်းကိန်းတန်ဖိုးများ (fractional values) တွင် မီလီစက္ကန့်များပါဝင်သည်)
ဥပမာများ	make_time(13,45,30.5) → time value 13:45:30.500

13.2.7.12. minute

ရက်စွဲအချိန်တစ်ခု သို့မဟုတ် အချိန်တစ်ခုမှ မိနစ်အစိတ်အပိုင်းများ သို့မဟုတ် အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုမှ မိနစ်အရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Time variant (အချိန်မူကွဲ)

ရက်စွဲအချိန်တစ်ခု သို့မဟုတ် အချိန်တစ်ခုမှ မိနစ်အစိတ်အပိုင်းများကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	minute(datetime)
Argument များ	datetime - အချိန် သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုးတစ်ခု
ဥပမာများ	minute( to_datetime('2012-07-22 13:24:57') ) → 24

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားအပိုင်းအခြားတစ်ခု၏ ကြာရှည်မှုကို မိနစ်များဖြင့် တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	minute(interval)
Argument များ	interval - မိနစ်အရေအတွက်များကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားအပိုင်းအခြားတန်ဖိုး
ဥပမာများ	minute(to_interval('3 minutes')) → 3 minute(age('2012-07-22T00:20:00','2012-07-22T00:00:00')) → 20 minute(age('2012-01-01','2010-01-01')) → 1051200

13.2.7.13. month

ရက်စွဲတစ်ခုမှ လအစိတ်အပိုင်း သို့မဟုတ် အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုမှ လအရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Date variant (ရက်စွဲမူကွဲ)

ရက်စွဲအချိန်တစ်ခု သို့မဟုတ် အချိန်တစ်ခုမှ လအစိတ်အပိုင်းများကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	month(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုးတစ်ခု
ဥပမာများ	month('2012-05-12') → 05

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားအပိုင်းအခြား တစ်ခု၏ ကြာရှည်မှုကို လများဖြင့်တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	month(interval)
Argument များ	interval - လအရေအတွက်များကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားအပိုင်းအခြားတန်ဖိုး
ဥပမာများ	month(to_interval('3 months')) → 3 month(age('2012-01-01','2010-01-01')) → 4.03333

13.2.7.14. now

လက်ရှိ အချိန်နှင့် ရက်စွဲကို ပြန်ထုတ်ပေးပါသည်။ Function (လုပ်ဆောင်ချက်သည်) static (တသမတ်တည်း) ဖြစ်ပြီး အကဲဖြတ်ခြင်း (evaluating) ပြုလုပ်သည့်အခါတွင် တသမတ်တည်းဖြစ်သောရလာဒ်များကို ပြန်ထုတ်ပေးပါသည်။ ပြန်ထုတ်ပေးသည့် အချိန်သည် expression ကို ပြင်ဆင်သည့်အခါတွင် ရှိသည့် အချိန်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	now()
ဥပမာများ	now() → 2012-07-22T13:24:57

13.2.7.15. second

ရက်စွဲအချိန်တစ်ခု သို့မဟုတ် အချိန်တစ်ခုမှ စက္ကန့်အစိတ်အပိုင်းများ သို့မဟုတ် အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုမှ စက္ကန့်အရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Time variant (အချိန်မူကွဲ)

ရက်စွဲအချိန်တစ်ခု သို့မဟုတ် အချိန်တစ်ခုမှ စက္ကန့်အစိတ်အပိုင်းများကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	second(datetime)
Argument များ	datetime - အချိန် သို့မဟုတ် ရက်စွဲအချိန်တစ်ခုတန်ဖိုး
ဥပမာများ	second( to_datetime('2012-07-22 13:24:57') ) → 57

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားအပိုင်းအခြား တစ်ခု၏ ရှည်ကြာမှုကို စက္ကန့်များဖြင့် တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	second(interval)
Argument များ	interval - စက္ကန့်အရေအတွက်များကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားအပိုင်းအခြား တန်ဖိုး
ဥပမာများ	second(to_interval('3 minutes')) → 180 second(age('2012-07-22T00:20:00','2012-07-22T00:00:00')) → 1200 second(age('2012-01-01','2010-01-01')) → 63072000

13.2.7.16. to_date

String တစ်ခုကို ရက်စွဲနှင့်သက်ဆိုင်သည့်အရာဝတ္ထု (date object) တစ်ခုအဖြစ်သို့ ပြောင်းလဲပေးပါသည်။ String ကို ခွဲခြမ်းစိတ်ဖြာမှုများ (parse) ပြုလုပ်ရန် စိတ်ကြိုက်ရွေးချယ်နိုင်သည့် format string တစ်ခုကို အသုံးပြုနိုင်ပါသည်။ QDate::fromString သို့မဟုတ် format ဆိုင်ရာ ထပ်ဆောင်းစာရွက်စာတမ်းများအတွက် format_date function ၏ documentation များကို ကြည့်ရှုပါ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူနေရာဒေသ) ကို အသုံးပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_date(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ရက်စွဲတန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို ရက်စွဲတစ်ခုအဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုမည့် format language - string ကို ရက်စွဲတစ်ခုအဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုသည့် ဘာသာစကား(lowercase(စကားလုံးအသေး)၊ two- or three-letter၊ ISO 639 language code)။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူနေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	to_date('2012-05-04') → 2012-05-04 to_date('June 29, 2019','MMMM d, yyyy') → လက်ရှိ locale သည် ၆ လပိုင်းအတွက် ‘June’ ဆိုသည့် အမည်ကို အသုံးပြုပါက 2019-06-29 ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည်။ သို့မဟုတ်ပါက error တစ်ခုဖြစ်ပါလိမ့်မည်။ to_date('29 juin, 2019','d MMMM, yyyy','fr') → 2019-06-29

13.2.7.17. to_datetime

String တစ်ခုကို ရက်စွဲအချိန်နှင့်သက်ဆိုင်သည့်အရာဝတ္ထု (datetime object) တစ်ခုအဖြစ်သို့ ပြောင်းလဲပေးပါသည်။ String ကို ခွဲခြမ်းစိတ်ဖြာမှုများ (parse) ပြုလုပ်ရန် စိတ်ကြိုက်ရွေးချယ်နိုင်သည့် format string တစ်ခုကို အသုံးပြုနိုင်ပါသည်။ QDate::fromString ၊ QTime::fromString သို့မဟုတ် format ဆိုင်ရာ ထပ်ဆောင်းစာရွက်စာတမ်းများအတွက် format_date function ၏ documentation များကို ကြည့်ရှုပါ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူနေရာဒေသ) ကို အသုံးပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_datetime(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ရက်စွဲအချိန် တန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို ရက်စွဲအချိန်တစ်ခု အဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုမည့် format language - string ကို ရက်စွဲအချိန် တစ်ခုအဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုသည့် ဘာသာစကား (lowercase(စကားလုံးအသေး)၊ two- or three-letter၊ ISO 639 language code)။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူနေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	to_datetime('2012-05-04 12:50:00') → 2012-05-04T12:50:00 to_datetime('June 29, 2019 @ 12:34','MMMM d, yyyy @ HH:mm') → လက်ရှိ locale သည် ၆ လပိုင်းအတွက် ‘June’ ဆိုသည့် အမည်ကို အသုံးပြုပါက 2019-06-29T12:34 ကိုပြန်ထုတ်ပေးပါမည်။ သို့မဟုတ်ပါက error တစ်ခုဖြစ်ပါလိမ့်မည်။ to_datetime('29 juin, 2019 @ 12:34','d MMMM, yyyy @ HH:mm','fr') → 2019-06-29T12:34

13.2.7.18. to_interval

String တစ်ခုကို အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) အမျိုးအစား တစ်ခုသို့ ပြောင်းလဲပေးပါသည်။ ရက်စွဲတစ်ခု၏ နေ့ရက်များ၊ နာရီများ၊ လ အစရှိသည်တို့ကို ရယူရာတွင် အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_interval(string)
Argument များ	string - အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string တစ်ခု။ ခွင့်ပြုထားသည့် format များတွင် {n} ရက်စွဲများ {n} နာရီများ {n} လများ ပါဝင်ပါသည်။
ဥပမာများ	to_interval('1 day 2 hours') → interval: 1.08333 days to_interval( '0.5 hours' ) → interval: 30 minutes to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

13.2.7.19. to_time

String တစ်ခုကို အချိန်နှင့်သက်ဆိုင်သည့်အရာဝတ္ထု (time object) တစ်ခုအဖြစ်သို့ ပြောင်းလဲပေးပါသည်။ String ကို ခွဲခြမ်းစိတ်ဖြာမှုများ (parse) ပြုလုပ်ရန် စိတ်ကြိုက်ရွေးချယ်နိုင်သည့် format string တစ်ခုကို အသုံးပြုနိုင်ပါသည်။ Format ဆိုင်ရာ ထပ်ဆောင်းစာရွက်စာတမ်းများအတွက် QTime::fromString ကို ကြည့်ရှုပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	to_time(string, [format], [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - အချိန် တန်ဖိုးတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် string format - string ကို အချိန်တစ်ခု အဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုသည့် format language - string ကို အချိန် တစ်ခုအဖြစ်သို့ ပြောင်းလဲရန် အသုံးပြုသည့် ဘာသာစကား(lowercase(စကားလုံးအသေး)၊ two- or three-letter၊ ISO 639 language code)
ဥပမာများ	to_time('12:30:01') → 12:30:01 to_time('12:34','HH:mm') → 12:34:00 to_time('12:34','HH:mm','fr') → 12:34:00

13.2.7.20. week

ရက်စွဲတစ်ခုမှ ရက်သတ္တပတ် ဂဏန်း သို့မဟုတ် အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုမှ ရက်သတ္တပတ်အရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Date variant (ရက်စွဲမူကွဲ)

ရက်စွဲတစ်ခု သို့မဟုတ် ရက်စွဲအချိန် တစ်ခုမှ ရက်သတ္တပတ် ဂဏန်းကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	week(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန်တန်ဖိုး တစ်ခု
ဥပမာများ	week('2012-05-12') → 19

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားအပိုင်းအခြားမူကွဲ (interval) တစ်ခု၏ ကာလအရှည်ကို ရက်သတ္တပတ်များဖြင့် တွက်ချက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	week(interval)
Argument များ	interval - လအရေအတွက်ကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားအပိုင်းအခြားတန်ဖိုး
ဥပမာများ	week(to_interval('3 weeks')) → 3 week(age('2012-01-01','2010-01-01')) → 104.285

13.2.7.21. year

ရက်စွဲ တစ်ခုမှ နှစ်အစိတ်အပိုင်း သို့မဟုတ် အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခုမှ နှစ်အရေအတွက်များကို ထုတ်ယူပေးပါသည်။

Date variant (ရက်စွဲမူကွဲ)

ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန်တစ်ခုမှ နှစ်အစိတ်အပိုင်း တစ်ခုကို ထုတ်ယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	year(date)
Argument များ	date - ရက်စွဲ သို့မဟုတ် ရက်စွဲအချိန်တန်ဖိုး တစ်ခု
ဥပမာများ	year('2012-05-12') → 2012

Interval variant (ကြားကာလအပိုင်းအခြားမူကွဲ)

အချိန်နှစ်ခုအကြားအပိုင်းအခြား (interval) တစ်ခု၏ ကာလအရှည်ကို နှစ်များဖြင့် တွက်ချက်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	year(interval)
Argument များ	interval - နှစ်အရေအတွက်ကို တွက်ချက်မည့် အချိန်နှစ်ခုအကြားအပိုင်းအခြားတန်ဖိုး
ဥပမာများ	year(to_interval('3 years')) → 3 year(age('2012-01-01','2010-01-01')) → 1.9986

အချို့ဥပမာများ

အဆိုပါ function များအပြင် - (အနုတ်) operator ကို အသုံးပြု၍ date များ၊ datetime များ သို့မဟုတ် time များကို နုတ်ခြင်းဖြင့် interval တစ်ခု ပြန်လည်ရရှိပါမည်။

+ (အပေါင်း) နှင့် - (အနုတ်) operator များကို အသုံးပြု၍ date များ၊ datetime များ သို့မဟုတ် time များသို့ interval တစ်ခုကို ပေါင်းထည့်ခြင်း သို့မဟုတ် နုတ်ခြင်းဖြင့် datetime တစ်ခု ပြန်လည်ရရှိပါမည်။

• QGIS 3.0 ဖြန့်ချိမှုမတိုင်မီအထိ ရက်အရေအတွက်ကို အောက်ပါအတိုင်း ရရှိနိုင်ပါသည်-

  to_date('2017-09-29') - to_date(now())
  -- Returns <interval: 203 days>
  

• အချိန်အတွက်လည်း ထို့အတူပင် ဖြစ်ပါသည်-

  to_datetime('2017-09-29 12:00:00') - now()
  -- Returns <interval: 202.49 days>
  

• ယခုမှစ၍ ရက်ပေါင်း ၁၀၀ ၏ datatime ကို ရရှိနိုင်ပါသည်-

  now() + to_interval('100 days')
  -- Returns <datetime: 2017-06-18 01:00:00>
  

13.2.8. Field များနှင့်တန်ဖိုးများ (Fields and Values)

Active (အသက်ဝင်လုပ်ဆောင်နိုင်သော) layer မှ field များစာရင်းတစ်ခုနှင့် အထူးတန်ဖိုးများ ပါရှိသည်။ Field များစာရင်းတွင် dataset ထဲတွင် သိမ်းဆည်းထားသော အရာများ၊ virtual နှင့် auxiliary (အရန်) အရာများပါဝင်သကဲ့သို့ joins (ချိတ်ဆက်မှုများ) များမှ အရာများလည်း ပါဝင်ပါသည်။

Expression တွင် ထည့်သွင်းရန် field အမည်တစ်ခုကို click နှစ်ချက်နှိပ်ပါ။ Field အမည် (double quotes (” “) အတွင်း) သို့မဟုတ် alias (အမည်ပို) ကို ရိုက်သွင်းပြီးလည်း ထည့်သွင်းနိုင်ပါသည်။

Expression တစ်ခုတွင် အသုံးပြုမည့် field တန်ဖိုးများကို ပြန်လည်ရယူရန် သင့်လျော်သော field ကို ရွေးချယ်ပြီး ပြထားသည့် widget တွင် 10 Samples (နမူနာ ၁၀ခု) နှင့် All Unique (ထူးခြားသည်များအားလုံး) တို့အကြား ရွေးချယ်ပါ။ တောင်းဆိုထားသောတန်ဖိုးများကို ပြသမည်ဖြစ်ပြီး ရလာဒ်ကိုစစ်ထုတ် (filter) ရန် စာရင်း၏ထိပ်ရှိ Search box ကို အသုံးပြုနိုင်ပါသည်။ Field တစ်ခုပေါ်တွင် ညာဖက် click နှိပ်ခြင်းဖြင့်လည်း နမူနာတန်ဖိုးများကို ရရှိစေနိုင်ပါသည်။

ရေးသားနေသည့် Expression တွင် တန်ဖိုးတစ်ခုထည့်သွင်းရန်၊ စာရင်းထဲတွင် ၎င်း expression ကို click နှစ်ချက်နှိပ်ပါ။ တန်ဖိုးသည် string အမျိုးအစားတစ်ခုဖြစ်ပါက၊ ၎င်းကို simple quote (’ ‘) ဖြင့်ထားပါ သို့မဟုတ်ပါက quote မလိုအပ်ပါ။

13.2.8.1. NULL

NULL တန်ဖိုးတစ်ခုနှင့် ညီမျှစေသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	NULL
ဥပမာ	NULL → NULL တန်ဖိုးတစ်ခု

Note

Null အတွက် စမ်းသပ်မှုပြုလုပ်ရန် IS NULL သို့မဟုတ် IS NOT NULL expression ကိုအသုံးပြုပါ။

13.2.9. ဖိုင်များနှင့် ဖိုင်သိမ်းဆည်းသည့်လမ်းကြောင်း Function များ (Files and Paths Functions)

ဤအုပ်စုတွင် ဖိုင်နှင့် လမ်းကြောင်းအမည်များကို ကိုင်တွယ်နိုင်သည့် function များ ပါရှိသည်။

13.2.9.1. base_file_name

ဖိုင်လမ်းကြောင်း သို့မဟုတ် ဖိုင်၏နောက်ဆက်စာလုံး (suffix) များမပါပဲ ဖိုင်၏အခြေခံအမည် (base name) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	base_file_name(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	base_file_name('/home/qgis/data/country_boundaries.shp') → ‘country_boundaries’

13.2.9.2. exif

ဓာတ်ပုံဖိုင်တစ်ခုမှ exif tag တန်ဖိုးများကို ရယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	exif(path, [tag]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	path - ဓာတ်ပုံဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။ tag - ပြန်ထုတ်ပေးမည့် tag ။ အကယ်၍ ဘာမှမထည့်ပေးထားလျှင် exif tag တန်ဖိုးများအားလုံးပါဝင်သော map တစ်ခုကို ပြန်ထုတ်ပေးပါလိမ့်မည်။
ဥပမာများ	exif('/my/photo.jpg','Exif.Image.Orientation') → 0

13.2.9.3. file_exists

ဖိုင်လမ်းကြောင်းတစ်ခု တည်ရှိနေလျှင် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	file_exists(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	file_exists('/home/qgis/data/country_boundaries.shp') → TRUE

13.2.9.4. file_name

ဖိုင်လမ်းကြောင်းမပါဝင်ပဲ ဖိုင်တစ်ခု၏အမည် (file extension အပါအဝင်) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	file_name(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	file_name('/home/qgis/data/country_boundaries.shp') → ‘country_boundaries.shp’

13.2.9.5. file_path

ဖိုင်လမ်းကြောင်း (path) တစ်ခု၏ လမ်းကြောင်း (directory) အစိတ်အပိုင်းကို ပြန်ထုတ်ပေးပါသည်။ ဖိုင်အမည်ပါဝင်မည် မဟုတ်ပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	file_path(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	file_path('/home/qgis/data/country_boundaries.shp') → ‘/home/qgis/data’

13.2.9.6. file_size

ဖိုင်တစ်ခု၏ အရွယ်အစား (bytes ဖြင့်) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	file_size(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	file_size('/home/qgis/data/country_boundaries.geojson') → 5674

13.2.9.7. file_suffix

ဖိုင်လမ်းကြောင်းတစ်ခုမှ ဖိုင်နောက်ဆက်စာလုံး (extension) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	file_suffix(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	file_suffix('/home/qgis/data/country_boundaries.shp') → ‘shp’

13.2.9.8. is_directory

ဖိုင်လမ်းကြောင်းတစ်ခု (path) သည် directory တစ်ခုနှင့်သက်ဆိုင်ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_directory(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	is_directory('/home/qgis/data/country_boundaries.shp') → FALSE is_directory('/home/qgis/data/') → TRUE

13.2.9.9. is_file

ဖိုင်လမ်းကြောင်း (path) တစ်ခုသည် ဖိုင်တစ်ခုနှင့် သက်ဆိုင်ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_file(path)
Argument များ	path - ဖိုင်လမ်းကြောင်းတစ်ခု သို့မဟုတ် map layer တန်ဖိုးတစ်ခု။ Map layer တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားပါက layer ၏ ဖိုင်ရင်းမြစ် ကို အသုံးပြုပါလိမ့်မည်။
ဥပမာများ	is_file('/home/qgis/data/country_boundaries.shp') → TRUE is_file('/home/qgis/data/') → FALSE

13.2.10. Form Functions များ

ဤအုပ်စုတွင် attribute form (အချက်အလက်ပြဇယား ပုံစံ) အကြောင်းအရာအောက်တွင် သီးသန့် လုပ်ဆောင်သည့် function များ ပါရှိသည်။ ဥပမာ- field’s widgets setting များထဲတွင်။

13.2.10.1. current_parent_value

Embed (ထည့်သွင်းမြှုပ်နှံထားသော) form အကြေင်းအရာတစ်ခုတွင်သာ အသုံးပြုနိုင်ပါသည်။ ဤ function သည် လက်ရှိ တည်းဖြတ်ပြင်ဆင်ခြင်းခံနေရသော parent form ထဲရှိ field တစ်ခု၏ လက်ရှိ မသိမ်းဆည်းရသေးသော တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် လက်ရှိတည်းဖြတ်ပြင်ဆင်ခြင်းခံနေရသော သို့မဟုတ် parent layer တစ်ခုထဲသို့ ပေါင်းထည့်ခြင်းမပြုရသေးသော feature များအတွက် parent feature ၏အမှန်တကယ် attribute တန်ဖိုးများနှင့် ကွဲပြားပါသည်။ Value-relation (တန်ဖိုး-ဆက်နွယ်မှု) widget filter expression တစ်ခုထဲတွင် အသုံးပြုသောအခါ ဤ function သည် ‘coalesce()’ တစ်ခုအဖြစ်သို့ wrap လုပ်သင့်ပါသည်၊ ၎င်း ‘coalesce()’ သည် form အား embed ပြုလုပ်ထားသောအကြောင်းအရာတစ်ခုထဲတွင် အသုံးမပြုသောအခါ layer မှ အမှန်တကယ် parent feature ကို ရယူပေးနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	current_parent_value(field_name)
Argument များ	field_name - လက်ရှိ parent form ထဲရှိ field အမည်တစ်ခု
ဥပမာများ	current_parent_value( 'FIELD_NAME' ) → Parent form ထဲရှိ ‘FIELD_NAME’ ဆိုသည့် field တစ်ခု၏ လက်ရှိတန်ဖိုး။

13.2.10.2. current_value

လက်ရှိ ပြင်ဆင်တည်းဖြတ်ခြင်းခံနေရသော form သို့မဟုတ် ဇယား row ထဲရှိ field တစ်ခု၏ လက်ရှိမသိမ်းဆည်းရသေးသော တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် လက်ရှိတည်းဖြတ်ပြင်ဆင်ခြင်းခံနေရသော သို့မဟုတ် layer တစ်ခုထဲသို့ ပေါင်းထည့်ခြင်းမပြုရသေးသော feature များအတွက် feature ၏အမှန်တကယ် attribute တန်ဖိုးများနှင့် ကွဲပြားပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	current_value(field_name)
Argument များ	field_name - လက်ရှိ form သို့မဟုတ် ဇယား row ထဲရှိ field အမည်တစ်ခု
ဥပမာများ	current_value( 'FIELD_NAME' ) → ‘FIELD_NAME’ ဆိုသည့် field ၏ လက်ရှိတန်ဖိုး။

13.2.11. Fuzzy Matching Functions

ဤအုပ်စုတွင် တန်ဖိုးများကြား တိကျသေချာမှုမရှိသော နှိုင်းယှဥ်မှုများအတွက် function များ ပါဝင်သည်။

13.2.11.1. hamming_distance

String နှစ်ခုအကြားရှိ Hamming (သက်ဆိုင်ရာသင်္ကေတများ ကွဲပြားသွားသည့် နေရာအရေအတွက်) အကွာအဝေးကို ပြန်ထုတ်ပေးပါသည်။ ထည့်သွင်းလိုက်သည့် string များအတွင်း character များ မတူညီသည့် သက်ဆိုင်ရာ နေရာများ၌ရှိသော character များအရေအတွက် ဖြစ်ပါသည်။ ထည့်သွင်းလိုက်သည့် string များသည် တူညီသော စာလုံးအရေအတွက်ရှိရမည်ဖြစ်ပြီး နှိုင်းယှဉ်ရာတွင် case-sensitive (စာလုံးအကြီးအသေးဂရုပြု) ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hamming_distance(string1, string2)
Argument များ	string1 - string တစ်ခု string2 - string တစ်ခု
ဥပမာများ	hamming_distance('abc','xec') → 2 hamming_distance('abc','ABc') → 2 hamming_distance(upper('abc'),upper('ABC')) → 0 hamming_distance('abc','abcd') → NULL

13.2.11.2. levenshtein

String နှစ်ခုအကြား Levenshtein edit အကွာအဝေးကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် string တစ်ခုမှ အခြား string တစ်ခုသို့ ပြောင်းလဲရန်လိုအပ်သော အနည်းဆုံး character ပြင်ဆင်မှုများ (ထပ်ထည့်ခြင်း၊ ဖျက်ပစ်ခြင်းများနှင့် အစားထိုးခြင်းများ) အရေအတွက်ဖြစ်ပါသည်။

Levenshtein အကွာအဝေး သည် string နှစ်ခုအကြား ဆင်တူညီမှု (similarity) ကို တိုင်းတာခြင်းဖြစ်သည်။ အကွာအဝေးနည်းလေလေ string များသည် ပိုမိုဆင်တူလေဖြစ်ပြီး အကွာအဝေးများလေလေ string များပိုမို ကွဲပြားလေ ဖြစ်ပါသည်။ အကွာအဝေး သည် case-sensitive (စာလုံးအကြီးအသေးဂရုပြု) ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	levenshtein(string1, string2)
Argument များ	string1 - string တစ်ခု string2 - string တစ်ခု
ဥပမာများ	levenshtein('kittens','mitten') → 2 levenshtein('Kitten','kitten') → 1 levenshtein(upper('Kitten'),upper('kitten')) → 0

13.2.11.3. longest_common_substring

Sting နှစ်ခုအကြား အရှည်ဆုံးဘုံဖြစ်သော string အခွဲ (substring) ကို ပြန်ထုတ်ပေးပါသည်။ ဤ string အခွဲသည် အရှည်ဆုံး string ဖြစ်ပြီး ထည့်သွင်းထားသည့် string နှစ်ခု၏ string အခွဲတစ်ခုဖြစ်ပါသည်။ ဥပမာအားဖြင့် “ABABC” နှင့် “BABCA” ၏ အရှည်ဆုံးဘုံဖြစ်သော string အခွဲမှာ “BABC” ဖြစ်ပါသည်။ String အခွဲသည် case-sensitive (စာလုံးအကြီးအသေးဂရုပြု) ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	longest_common_substring(string1, string2)
Argument များ	string1 - string တစ်ခု string2 - string တစ်ခု
ဥပမာများ	longest_common_substring('ABABC','BABCA') → ‘BABC’ longest_common_substring('abcDeF','abcdef') → ‘abc’ longest_common_substring(upper('abcDeF'),upper('abcdex')) → ‘ABCDE’

13.2.11.4. soundex

String တစ်ခု၏ Soundex ကိုယ်စားပြုမှုကို ပြန်ထုတ်ပေးပါသည်။ Soundex ဆိုသည်မှာ phonetic (အသံထွက်နှင့်ဆိုင်သော) ကိုက်ညီမှု algorithm တစ်ခုဖြစ်ပါသည်၊ ထို့ကြောင့် အသံထွက်ဆင်တူသော string များကို တူညီသော Soundex ကုဒ် ဖြင့် ကိုယ်စားပြုဖော်ပြသင့်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	soundex(string)
Argument များ	string - string တစ်ခု
ဥပမာများ	soundex('robert') → ‘R163’ soundex('rupert') → ‘R163’ soundex('rubin') → ‘R150’

13.2.12. အထွေထွေ Function များ (General Functions)

ဤအုပ်စုတွင် အထွေထွေ function အမျိုးမျိုး ပါဝင်ပါသည်။

13.2.12.1. env

Environment variable (ကိန်းရှင်) တစ်ခုကိုယူ၍ ၎င်း၏အကြောင်းအရာကို string တစ်ခုအဖြစ် ပြန်ထုတ်ပေးပါသည်။ Variable ကို ရှာမတွေ့ခဲ့လျှင် NULL ကို ပြန်ထုတ်ပေးပါလိမ့်မည်။ ၎င်းသည် Drive letter များ (C: ၊ D: ၊ E:) သို့မဟုတ် လမ်းကြောင်းရှေ့ဆက်စာလုံး (prefix) များကဲ့သို့ စနစ်ဆိုင်ရာသီးသန့် ပြင်ဆင်သတ်မှတ်မှုများကို ဖြည့်သွင်းရာတွင် လွယ်ကူပါသည်။ Environment variable များ၏ အဓိပ္ပါယ်သတ်မှတ်ချက်မှာ operating system ပေါ်တွင် မူတည်ပါသည်။ ၎င်းကို မည်သို့သတ်မှတ်နိုင်မည်ကို system administrator သို့မဟုတ် operating system documentation တွင် စစ်ဆေးကြည့်ပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	env(name)
Argument များ	name - ရယူသင့်သည့် environment variable ၏အမည်
ဥပမာများ	env( 'LANG' ) → ‘en_US.UTF-8’ env( 'MY_OWN_PREFIX_VAR' ) → ‘Z:’ env( 'I_DO_NOT_EXIST' ) → NULL

13.2.12.2. eval

String တစ်ခုထဲတွင် လုပ်ဆောင်သော expression တစ်ခုကို အကဲဖြတ်သုံးသပ်ပေးပါသည်။ အကြောင်းအရာဆိုင်ရာ variable များ သို့မဟုတ် field များအနေဖြင့် လုပ်ဆောင်သော dynamic (ပြောင်းလဲနိုင်သော) parameter များကို ချဲ့ထွင်ရာတွင် အသုံးဝင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	eval(expression)
Argument များ	expression - expression string တစ်ခု
ဥပမာများ	eval('\'nice\'') → ‘nice’ eval(@expression_var) → [whatever the result of evaluating @expression_var might be…]

13.2.12.3. eval_template

String တစ်ခုထဲတွင် လုပ်ဆောင်သော template (နမူနာပုံစံ) တစ်ခုကို အကဲဖြတ်သုံးသပ်ပါသည်။ အကြောင်းအရာဆိုင်ရာ variable များ သို့မဟုတ် field များအနေဖြင့် လုပ်ဆောင်သော dynamic (ပြောင်းလဲနိုင်သော) parameter များကို ချဲ့ထွင်ရာတွင် အသုံးဝင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	eval_template(template)
Arguments	template - template string တစ်ခု
ဥပမာများ	eval_template('QGIS [% upper(\'rocks\') %]') → QGIS ROCKS

13.2.12.4. is_layer_visible

သတ်မှတ်ထားသော layer တစ်ခုသည် မြင်ရနိုင်လျှင် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_layer_visible(layer)
Argument များ	layer - layer အမည် သို့မဟုတ် layer ID တစ်ခုကို ကိုယ်စားပြုသော string တစ်ခု
ဥပမာများ	is_layer_visible('baseraster') → TRUE

13.2.12.5. mime_type

Binary data ၏ mime (စကားလုံးနှစ်လုံးပါဝင်ပြီး ပထမစာလုံးသည် ဖိုင်၏ယေဘုယျအမျိုးအစားကိုဖော်ပြပြီး ဒုတိယစာလုံးသည် ဖိုင် format ကိုဖော်ပြသည်) အမျိုးအစားကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	mime_type(bytes)
Argument များ	bytes - binary data
ဥပမာများ	mime_type('<html><body></body></html>') → text/html mime_type(from_base64('R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAIAOw==')) → image/gif

13.2.12.6. var

သတ်မှတ်ထားသော variable (ကိန်းရှင်) တစ်ခုအတွင်း သိမ်းဆည်းထားသော တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	var(name)
Argument များ	name - variable အမည်တစ်ခု
ဥပမာများ	var('qgis_version') → ‘2.12’

ထပ်မံဖတ်ရှုရန်- Default variables စာရင်း

13.2.12.7. with_variable

ဤ function သည် 3rd (တတိယမြောက်) argument အဖြစ်ပံ့ပိုးပေးမည့် မည်သည့် expression code အတွက်မဆို variable တစ်ခုကို သတ်မှတ်ပေးပါသည်။ ၎င်းသည် တွက်ချက်ထားသော တူညီသည့်တန်ဖိုးကို အခြားမတူညီသော နေရာများတွင် အသုံးပြုရန်လိုအပ်သည့် ရှုပ်ထွေးသော expression များအတွက်သာ အသုံးဝင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	with_variable(name, value, expression)
Argument များ	name - သတ်မှတ်မည့် variable ၏အမည် value - သတ်မှတ်မည့် တန်ဖိုး expression - ရရှိနိုင်မည့် variable အတွက် expression
ဥပမာများ	with_variable('my_sum', 1 + 2 + 3, @my_sum * 2 + @my_sum * 5) → 42

13.2.13. ဂျီသြမေတြီ Function များ (Geometry Functions)

ဤအုပ်စုတွင် ဂျီသြမေတြီ အရာများပေါ်တွင် လုပ်ဆောင်နိုင်သည့် function များ ပါဝင်ပါသည်။ (ဥပမာ- buffer (ကြားခံနယ်များ)၊ transform (ပြောင်းလဲခြင်း)၊ $area (ဧရိယာတွက်ချက်ခြင်း))။

13.2.13.1. affine_transform

ဤ function သည် သဏ္ဍာန်မပျက်အသွင်ပြောင်းလဲ (affine transformation) ပြီးနောက် ဂျီဩမေတြီကို ပြန်ထုတ်ပေးပြီး တွက်ချက်မှုများကို ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဆောင်ရွက်သွားမည်ဖြစ်သည်။ ထိုလုပ်ဆောင်ချက်များသည် ဂျီဩမေတြီများကို ၎င်းတို့၏ စကေး၊ လှည့်ထောင့်နှင့် ပြောင်းလဲခြင်းအစဉ်အတိုင်း ဆောင်ရွက်ပါသည်။ အကယ်၍ ဂျီဩမေတြီတွင် Z သို့မဟုတ် M အရွေ့ (offset) ရှိပြီး ကိုဩဒိနိတ်မပါရှိလျှင် ၎င်းတို့ကို ပေါင်းထည့်ပေးသွားပါလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	affine_transform(geometry, delta_x, delta_y, rotation_z, scale_x, scale_y, [delta_z=0], [delta_m=0], [scale_z=1], [scale_m=1]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလုပ်သော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု delta_x - x ဝင်ရိုး ရွှေ့ပြောင်းခြင်း delta_y - y ဝင်ရိုး ရွှေ့ပြောင်းခြင်း rotation_z - z ဝင်ရိုးတွင် ဒီဂရီဖြင့်ဖော်ပြသော နာရီလက်တံအတိုင်းလှည့်ထောင့် scale_x - x ဝင်ရိုး စကေး factor scale_y - y ဝင်ရိုး စကေး factor delta_z - z ဝင်ရိုး ရွှေ့ပြောင်းခြင်း delta_m - m ဝင်ရိုး ရွှေ့ပြောင်းခြင်း scale_z - z ဝင်ရိုး စကေး factor scale_m - m ဝင်ရိုး စကေး factor
ဥပမာများ	geom_to_wkt(affine_transform(geom_from_wkt('LINESTRING(1 1, 2 2)'), 2, 2, 0, 1, 1)) → ‘LineString (3 3, 4 4)’ geom_to_wkt(affine_transform(geom_from_wkt('POLYGON((0 0, 0 3, 2 2, 0 0))'), 0, 0, -90, 1, 2)) → ‘Polygon ((0 0, 6 0, 4 -2, 0 0))’ geom_to_wkt(affine_transform(geom_from_wkt('POINT(3 1)'), 0, 0, 0, 1, 1, 5, 0)) → ‘PointZ (3 1 5)’

13.2.13.2. angle_at_vertex

ဤ function သည် မျဉ်းအဆစ်များဆက်ထားသည့် မျဉ်းကြောင်း (linestring) ဂျီဩမေတြီတစ်ခုရှိ သတ်မှတ်ထားသောမျဉ်းဆစ်တစ်ခုအတွက် ပျမ်းမျှထောင့်ကို ရရှိစေပြီး ထောင့်များကို မြောက်အရပ်မှ နာရီလက်တံအတိုင်း ဒီဂရီဖြင့် ရေတွက်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	angle_at_vertex(geometry, vertex)
Argument များ	geometry - linestring ဂျီဩမေတြီ တစ်ခု vertex - မျဉ်းအဆစ်အညွှန်းကိန်း (vertex index) သည် သုညမှ စတင်သည်၊ အကယ်၍ အနှုတ်တန်ဖိုးဖြစ်နေခဲ့လျှင် ရွေးချယ်ထားသော မျဉ်းအဆစ်အညွှန်းကိန်းသည် ၎င်း၏မျဉ်းဆစ်အရေအတွက် စုစုပေါင်းထဲမှ ပကတိတန်ဖိုးကို နုတ်ထားခြင်းဖြစ်သည်။
ဥပမာများ	angle_at_vertex(geometry:=geom_from_wkt('LineString(0 0, 10 0, 10 10)'),vertex:=1) → 45.0

13.2.13.3. apply_dash_pattern

ဂျီဩမေတြီတစ်ခုတွင် မျဉ်းတိုအတုံးသဏ္ဍာန် (dash pattern) တစ်ခုကို အသုံးပြုပေးပြီး မူရင်း input ဂျီဩမေတြီကို မျဉ်း/ကွင်းဆက်တစ်လျှောက်တွင် သတ်မှတ်ထားသော pattern ဖြင့် ရေးဆွဲထားသော MultiLineString (မျဉ်းကြောင်းများစွာပါဝင်သည့်) ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	apply_dash_pattern(geometry, pattern, [start_rule=no_rule], [end_rule=no_rule], [adjustment=both], [pattern_offset=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု (linestring (များစွာ) သို့မဟုတ် polygon (များစွာ) အကျုံးဝင်ပါသည်)။ pattern - dash နှင့် gap (ကွက်လပ်) အလျားများကို ကိုယ်စားပြုသော ကိန်းများအစု (array of numbers) တစ်ခုအဖြစ် ဖော်ပြထားသည့် dash pattern ကိုဆိုလိုခြင်းဖြစ်ပြီး ၎င်းတွင် အရေအတွက်အားဖြင့် စုံဂဏန်းပါဝင်ရမည်ဖြစ်ပါသည်။ start_rule - Pattern စတင်မှုကို ကန့်သတ်ရန်အတွက် ရွေးချယ်နိုင်သော စည်းမျဉ်းဖြစ်ပါသည်။ ရွေးချယ်ရနိုင်သော တန်ဖိုးများမှာ ‘no_rule’ (စည်းမျဉ်းမသတ်မှတ်ပါ) ၊ ‘full_dash’ (မျဉ်းတိုအတုံးအပြည့်) ၊ ‘half_dash’ (မျဉ်းတိုအတုံးတစ်ဝက်) ၊ ‘full_gap’ (ကွက်လပ်အပြည့်) ၊ ‘half_gap’ (ကွက်လပ်တစ်ဝက်) တို့ဖြစ်ပါသည်။ end_rule - Pattern ပြီးဆုံးမှုကို ကန့်သတ်ရန်အတွက် ရွေးချယ်နိုင်သော စည်းမျဉ်းဖြစ်ပါသည်။ ရွေးချယ်ရနိုင်သော တန်ဖိုးများမှာ ‘no_rule’ (စည်းမျဉ်းမသတ်မှတ်ပါ) ၊ ‘full_dash’ (မျဉ်းတိုအတုံးအပြည့်) ၊ ‘half_dash’ (မျဉ်းတိုအတုံးတစ်ဝက်) ၊ ‘full_gap’ (ကွက်လပ်အပြည့်) ၊ ‘half_gap’ (ကွက်လပ်တစ်ဝက်) တို့ဖြစ်ပါသည်။ adjustment - အလိုရှိသော pattern စည်းမျဉ်းများနှင့် ကိုက်ညီစေရန် မည်သည့် pattern အစိတ်အပိုင်းများတွင် ချိန်ညှိခြင်းပြုလုပ်မည်ကို သတ်မှတ်ရန် ရွေးချယ်နိုင်သော စည်းမျဉ်းဖြစ်ပါသည်။ ရွေးချယ်ရနိုင်သော တန်ဖိုးများမှာ ‘both’ (နှစ်မျိုးစလုံး)၊ ‘dash’ (မျဉ်းတိုအတုံး) နှင့် ‘gap’ (ကွက်လပ်) တို့ဖြစ်ပါသည်။ pattern_offset - Pattern တလျှောက် စတင်သည့် သီးသန့်အကွာအဝေးကို သတ်မှတ်ရန် ရွေးချယ်မှုပြုလုပ်နိုင်သော အကွာအဝေးဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(apply_dash_pattern(geom_from_wkt('LINESTRING(1 1, 10 1)'), array(3, 1))) → MultiLineString ((1 1, 4 1),(5 1, 8 1),(9 1, 10 1, 10 1)) geom_to_wkt(apply_dash_pattern(geom_from_wkt('LINESTRING(1 1, 10 1)'), array(3, 1), start_rule:='half_dash')) → MultiLineString ((1 1, 2.5 1),(3.5 1, 6.5 1),(7.5 1, 10 1, 10 1))

13.2.13.4. $area

လက်ရှိ feature ၏ဧရိယာကို ပြန်ထုတ်ပေးပါသည်။ ဤ function ဖြင့် တွက်ချက်ရရှိသော ဧရိယာသည် လက်ရှိ project ၏ စက်လုံးပုံ (ellipsoid) setting နှင့် ဧရိယာယူနစ် setting များ နှစ်ခုစလုံးနှင့် စပ်လျဉ်းပါသည်။ ဥပမာအားဖြင့် project အတွက် ellipsoid တစ်ခုကိုသတ်မှတ်ထားမည်ဆိုပါက တွက်ထုတ်လိုက်သော ဧရိယာသည်လည်း စက်လုံးပုံဆိုင်ရာ (ellipsoidal )ဧရိယာဖြစ်နေမည်ဖြစ်ပြီး အကယ်၍ ellipsoid သတ်မှတ်မထားပါက တွက်ထုတ်လိုက်သော ဧရိယာသည် ပြင်ညီမျက်နှာပြင်ဆိုင်ရာ (planimetric) ဧရိယာဖြစ်နေပေလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$area
ဥပမာများ	$area → 42

13.2.13.5. area

ဂျီဩမေတြီ polygon တစ်ခု၏ ဧရိယာကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာဆိုင်ရာရည်ညွှန်းစနစ် (Spatial Reference System (SRS)) အရ အမြဲတမ်း ပြင်ညီမျက်နှာပြင်ဆိုင်ရာ (planimetric) တိုင်းတာမှုဖြစ်နေမည်ဖြစ်ပြီး ရရှိလာသော ဧရိယာ၏ ယူနစ်သည်လည်း SRS အတွက်ယူနစ်များနှင့် ကိုက်ညီနေမည်ဖြစ်ပါသည်။ ဤ function သည် $area function ဖြင့် တွက်ချက်သော ဧရိယာဖြင့် ကွာခြားပါသည်။ $area function တွင် project ၏ ellipsoid setting နှင့် ဧရိယာယူနစ် setting များပေါ် မူတည်၍ ellipsoidal တွက်ချက်မှုများကို လုပ်ဆောင်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	area(geometry)
Argument များ	geometry - polygon ဂျီဩမေတြီ
ဥပမာများ	area(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))')) → 8.0

13.2.13.6. azimuth

ဤ function သည် အမှတ် a မှ အမှတ် b သို့ ဒေါင်လိုက်အနေအထားမှ နာရီလက်တံအတိုင်းတိုင်းတာသော မြောက်အရပ်အခြေခံ ဦးတည်ရာထောင့် (azimuth) ကို radian ဖြင့် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	azimuth(point_a, point_b)
Argument များ	point_a - point geometry point_b - point geometry
ဥပမာများ	degrees( azimuth( make_point(25, 45), make_point(75, 100) ) ) → 42.273689 degrees( azimuth( make_point(75, 100), make_point(25,45) ) ) → 222.273689

13.2.13.7. boundary

ဤ function သည် ဂျီဩမေတြီပုံသဏ္ဍာန်တစ်ခု၏ ပေါင်းစပ်နယ်နိမိတ် အနားသတ်များ (ဆိုလိုသည်မှာ ဂျီဩမေတြီတစ်ခု၏ ဖွဲ့စည်းပုံနယ်နိမိတ်များ) ထိစပ်ခြင်းကို ပြန်ထုတ်ပေးပါသည်။ ဥပမာအားဖြင့် polygon ဂျီဩမေတြီတစ်ခုတွင် ထို polygon အတွင်းရှိ ring တစ်ခုစီအတွက် linestring များပါဝင်နေသော နယ်နိမိတ်တစ်ခုရှိမည်ဖြစ်သည်။ အချို့သော ဂျီဩမေတြီအမျိုးအစားများတွင် နယ်နိမိတ်သတ်မှတ်ချက်မရှိပေ။ ဥပမာ- point များ သို့မဟုတ် ဂျီဩမေတြီစုစည်းမှုများဖြစ်ပြီး NULL ကို ပြန်ထုတ်ပေးပါလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	boundary(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(boundary(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘LineString(1 1,0 0,-1 1,1 1)’ geom_to_wkt(boundary(geom_from_wkt('LineString(1 1,0 0,-1 1)'))) → ‘MultiPoint ((1 1),(-1 1))’

ထပ်မံဖတ်ရှုရန်- နယ်နိမိတ် (Boundary) algorithm

13.2.13.8. bounds

ဤ function သည် ထည့်သွင်းလိုက်သော ဂျီဩမေတြီ၏ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) ကို ကိုယ်စားပြုသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဆောင်ရွက်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	bounds(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	bounds(@geometry) → လက်ရှိ feature ၏ ဂျီဩမေတြီ၏ bounding box geom_to_wkt(bounds(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘Polygon ((-1 0, 1 0, 1 1, -1 1, -1 0))’

Fig. 13.4 အနက်ရောင်မျဉ်းများသည် polygon feature တစ်ခုစီ၏ bounding box များကို ကိုယ်စားပြုပါသည်။

ထပ်မံဖတ်ရှုရန်- လေးမျက်နှာအကျယ်အဝန်းနယ်များ (Bounding boxes) algorithm

13.2.13.9. bounds_height

ဤ function သည် ဂျီဩမေတြီတစ်ခုရှိ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) ၏အမြင့်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဆောင်ရွက်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	bounds_height(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	bounds_height(@geometry) → လက်ရှိ feature ဂျီဩမေတြီရှိ bounding box ၏အမြင့် bounds_height(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')) → 1

13.2.13.10. bounds_width

ဤ function သည် ဂျီဩမေတြီတစ်ခုရှိ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) ၏အကျယ်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဆောင်ရွက်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	bounds_width(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	bounds_width(@geometry) → လက်ရှိ feature ဂျီဩမေတြီရှိ bounding box ၏အကျယ် bounds_width(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')) → 2

13.2.13.11. buffer

ဤ function သည် ဂျီဩမေတြီတစ်ခုမှ အကွာအဝေးနည်းသော သို့မဟုတ် ထိုအကွာအဝေးနှင့်ညီမျှသော point များကို ကိုယ်စားပြုသည့် ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဆောင်ရွက်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	buffer(geometry, distance, [segments=8], [cap=’round’], [join=’round’], [miter_limit=2]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု distance - Layer ၏ ယူနစ်များဖြင့် buffer အကွာအဝေး segments - ထိပ်လုံးအဆက် (round join) style ကို အသုံးပြုသောအခါ စက်ဝိုင်း၏လေးပုံတစ်ပုံရှိသော စက်ဝန်းပိုင်းတစ်ခုကို ကိုယ်စားပြုရန် မျဉ်းပိုင်းအရေအတွက်။ မျဉ်းပိုင်း အရေအတွက် ပိုများပါက အဆစ် (node) များပိုမိုပါဝင်သည့် ချောမွေ့သော buffer ကို ရရှိစေပါသည်။ cap - buffer အတွက် အနားသတ်ပုံစံ။ အသုံးပြုနိုင်သောပုံစံများမှာ ‘round’ ၊ ‘flat’ သို့မဟုတ် ‘square’ တို့ဖြစ်သည်။ join - buffer အတွက် အဆက် (join) ပုံစံ။ အသုံးပြုနိုင်သော ပုံစံများမှာ ‘round’ ၊ ‘bevel’ သို့မဟုတ် ‘miter’ တို့ဖြစ်သည်။ miter_limit - ‘miter’ အဆက် style ကို အသုံးပြုသောအခါ ၎င်း၏ miter အကွာအဝေးသတ်မှတ်ချက်
ဥပမာများ	buffer(@geometry, 10.5) → လက်ရှိ feature ၏ ဂျီဩမေတြီကို 10.5 ယူနစ်ဖြင့် ကြားခံပြုလုပ်ထားသည့် polygon

Fig. 13.5 Point များ၊ line ၊ အပေါင်း buffer လုပ်ထားသော polygon နှင့် အနှုတ် buffer လုပ်ထားသော polygon တို့၏ buffer (အဝါရောင်)

ထပ်မံဖတ်ရှုရန်- ကြားခံဇုံ (Buffer) algorithm

13.2.13.12. buffer_by_m

ဤ function သည် မျဉ်းအဆစ်များ၌ရှိသော m တန်ဖိုးအလိုက် buffer အချင်း ပြောင်းလဲသည့် line ဂျီဩမေတြီတလျှောက် buffer တစ်ခုကိုဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	buffer_by_m(geometry, [segments=8]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ထည့်သွင်းသောဂျီဩမေတြီ။ m တန်ဖိုးများရှိသည့် line (များစွာ) ဂျီဩမေတြီ တစ်ခု ဖြစ်ရမည်။ segments - Buffer ထဲတွင် လေးပုံတစ်ပုံရှိသောစက်ဝန်းပိုင်းအကွေးများကို အနီးစပ်ဆုံးဖော်ပြသည့် မျဉ်းပိုင်းများအရေအတွက်
ဥပမာများ	buffer_by_m(geometry:=geom_from_wkt('LINESTRINGM(1 2 0.5, 4 2 0.2)'),segments:=8) → Linestring ဂျီဩမေတြီတလျှောက် အစတွင် 0.5 အချင်းရှိပြီး အဆုံးသတ်တွင် 0.2 အချင်းရှိသော အကျယ်ပြောင်းလဲနိုင်သည့် buffer တစ်ခု

Fig. 13.6 မျဉ်းအဆစ်များရှိ m တန်ဖိုးများကို အသုံးပြုပြီး line feature များကို buffer ပြုလုပ်ခြင်း

ထပ်မံဖတ်ရှုရန်- M value သုံးပြီး ကြားခံနယ်များ ပြုလုပ်ခြင်း (Variable width buffer) algorithm

13.2.13.13. centroid

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အလယ်ဗဟိုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	centroid(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	centroid(@geometry) → point ဂျီဩမေတြီတစ်ခု

ထပ်မံဖတ်ရှုရန်- အလယ်/ဗဟိုမှတ်များ (Centroids) algorithm

13.2.13.14. close_line

ဤ function သည် ထည့်သွင်းလိုက်သော မျဉ်းသည် မျဉ်းပိတ် ဖြစ်မနေလျှင် အဆိုပါမျဉ်း၏ ပထမအမှတ်ကို မျဉ်းအဆုံးအထိ ဆက်ပေးခြင်းဖြင့် မျဉ်းပိတ်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ဂျီဩမေတြီသည် မျဉ်းကြောင်း (line string) သို့မဟုတ် မျဉ်းများစွာပါဝင်သောမျဉ်းတစ်ကြောင်း (multi line string) မဟုတ်ခဲ့ပါက ရလဒ်သည် NULL ဖြစ်နေပေလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	close_line(geometry)
Argument များ	geometry - line string ဂျီဩမေတြီ တစ်ခု
ဥပမာများ	geom_to_wkt(close_line(geom_from_wkt('LINESTRING(0 0, 1 0, 1 1)'))) → ‘LineString (0 0, 1 0, 1 1, 0 0)’ geom_to_wkt(close_line(geom_from_wkt('LINESTRING(0 0, 1 0, 1 1, 0 0)'))) → ‘LineString (0 0, 1 0, 1 1, 0 0)’

13.2.13.15. closest_point

ဤ function သည် ဂျီဩမေတြီ (၂) နှင့် အနီးကပ်ဆုံးရှိသည့် ဂျီဩမေတြီ (၁) ပေါ်တွင် အမှတ်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	closest_point(geometry1, geometry2)
Argument များ	geometry1 - ၎င်းအပေါ်တွင် အနီးကပ်ဆုံးအမှတ်ကို ရှာမည့် ဂျီဩမေတြီ geometry2 - ၎င်းနှင့် အနီးကပ်ဆုံးအမှတ်ကို ရှာမည့် ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(closest_point(geom_from_wkt('LINESTRING (20 80, 98 190, 110 180, 50 75 )'),geom_from_wkt('POINT(100 100)'))) → ‘Point(73.0769 115.384)’

13.2.13.16. collect_geometries

ဤ function သည် ဂျီဩမေတြီအစုတစ်ခုကို အစိတ်အပိုင်းများစွာပါဝင်သော ဂျီဩမေတြီတစ်ခုအဖြစ်သို့ စုစည်းပေးပါသည်။

List of arguments variant (Argument မူကွဲများစာရင်း)

ဂျီဩမေတြီအစိတ်အပိုင်းများကို function တွင် သီးခြား argument များအဖြစ် သတ်မှတ်ထားပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	collect_geometries(geometry1, geometry2, …)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(collect_geometries(make_point(1,2), make_point(3,4), make_point(5,6))) → ‘MultiPoint ((1 2),(3 4),(5 6))’

Array variant (Array မူကွဲ)

ဂျီဩမေတြီအစိတ်အပိုင်းများကို ဂျီဩမေတြီအစိတ်အပိုင်းများ၏ array တစ်ခုအနေဖြင့် သတ်မှတ်ထားပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	collect_geometries(array)
Argument များ	array - ဂျီဩမေတြီများ၏ array
ဥပမာများ	geom_to_wkt(collect_geometries(array(make_point(1,2), make_point(3,4), make_point(5,6)))) → ‘MultiPoint ((1 2),(3 4),(5 6))’

ထပ်မံဖတ်ရှုရန်- ဂျီဩမေတြီ များစုစည်းခြင်း (Collect geometries) algorithm

13.2.13.17. combine

ဤ function သည် ဂျီဩမေတြီနှစ်ခု ပေါင်းစပ်ခြင်းကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	combine(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( combine( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 2 1)' ) ) ) → ‘MULTILINESTRING((4 4, 2 1), (3 3, 4 4), (4 4, 5 5))’ geom_to_wkt( combine( geom_from_wkt( 'LINESTRING(3 3, 4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 6 6, 2 1)' ) ) ) → ‘LINESTRING(3 3, 4 4, 6 6, 2 1)’

13.2.13.18. concave_hull

ဤ function သည် ဂျီဩမေတြီထဲရှိ point များအားလုံးပါဝင်သော ခွက်နေသည့် (concave) polygon တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	concave_hull(geometry, target_percent, [allow_holes=False]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု target_percent - ဤလုပ်ဆောင်ချက်မှ ဆောင်ရွက်မည့် convex (ခုံးနေသော) hull ဧရိယာ ရာခိုင်နှုန်းဖြစ်ပါသည်။ သတ်မှတ်ရာခိုင်နှုန်းသည် ၁ ဖြစ်ပါက convex (ခုံးနေသော) hull အတိုင်း ရလာဒ်အတူတူကို ရရှိမည်ဖြစ်ပြီး သတ်မှတ်ရာခိုင်နှုန်းသည် 0 နှင့် 0.99 ကြားရှိပါက convex (ခုံးနေသော) hull ၏ ဧရိယာထက် ပိုမိုသေးငယ်သော ဧရိယာကို ရရှိမည်ဖြစ်သည်။ allow_holes - ရလာဒ် ဂျီဩမေတြီ အတွင်းတွင် အပေါက်များ (hole) ကို ခွင့်ပြု/မပြု သတ်မှတ်ပေးနိုင်သည့် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument တစ်ခုဖြစ်ပါသည်။ FALSE သည် default ဖြစ်ပြီး ရလာဒ် ဂျီဩမေတြီ အတွင်းတွင် အပေါက်များ မပါဝင်လိုပါက TRUE ကို သတ်မှတ်ရပါမည်။
ဥပမာများ	geom_to_wkt(concave_hull(geom_from_wkt('MULTILINESTRING((106 164,30 112,74 70,82 112,130 94,130 62,122 40,156 32,162 76,172 88),(132 178,134 148,128 136,96 128,132 108,150 130,170 142,174 110,156 96,158 90,158 88),(22 64,66 28,94 38,94 68,114 76,112 30,132 10,168 18,178 34,186 52,184 74,190 100,190 122,182 148,178 170,176 184,156 164,146 178,132 186,92 182,56 158,36 150,62 150,76 128,88 118))'), 0.99)) → ‘Polygon ((30 112, 36 150, 92 182, 132 186, 176 184, 190 122, 190 100, 186 52, 178 34, 168 18, 132 10, 112 30, 66 28, 22 64, 30 112))’

ထပ်မံဖတ်ရှုရန်- convex_hull

13.2.13.19. contains

ဤ function သည် ဂျီဩမေတြီတစ်ခုအတွင်း အခြားဂျီဩမေတြီတစ်ခုပါဝင်နေမှု ရှိ/မရှိ စစ်ဆေးပေးပါသည်။ ဂျီဩမေတြီ (၂)၏ point များသည် ဂျီဩမေတြီ (၁)၏ အပြင်ပိုင်းတွင် လုံးဝ ကျရောက်မနေလျှင်သော်လည်းကောင်း၊ ဂျီဩမေတြီ (၂)အတွင်းပိုင်းရှိ အနည်းဆုံး point တစ်ခုသည် ဂျီဩမေတြီ (၁)၏ အတွင်းပိုင်းတွင် ကျရောက်နေခဲ့လျှင်သော်လည်းကောင်း TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	contains(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	contains( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ), geom_from_wkt( 'POINT(0.5 0.5 )' ) ) → TRUE contains( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_contains

13.2.13.20. convex_hull

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ convex (ခုံးနေသော) hull ကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် အစုအတွင်းရှိ ဂျီဩမေတြီများအားလုံးကို လွှမ်းခြုံသော အနည်းဆုံး ခုံးနေသည့် ဂျီဩမေတြီကို ကိုယ်စားပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	convex_hull(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( convex_hull( geom_from_wkt( 'LINESTRING(3 3, 4 4, 4 10)' ) ) ) → ‘POLYGON((3 3, 4 10, 4 4, 3 3))’

ထပ်မံဖတ်ရှုရန်- concave_hull ၊ Convex hull algorithm

13.2.13.21. crosses

ဤ function သည် ဂျီဩမေတြီတစ်ခုနှင့် တစ်ခု ဖြတ်နေခြင်း ရှိ/မရှိ စစ်ဆေးပေးပါသည်။ ပေးထားသော ဂျီဩမေတြီများတွင် အတွင်းပိုင်း point များအားလုံးမဟုတ်သော်လည်း point အချို့ သည် ဘုံတူညီနေမှု ရှိနေခဲ့လျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	crosses(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	crosses( geom_from_wkt( 'LINESTRING(3 5, 4 4, 5 3)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE crosses( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_crosses

13.2.13.22. densify_by_count

ဤ function သည် polygon သို့မဟုတ် line layer ဂျီဩမေတြီတစ်ခုကိုယူ၍ မူလဂျီဩမေတြီထက် မျဉ်းဆစ် (vertex) များစွာပါဝင်သော ဂျီဩမေတြီအသစ် တစ်ခုကို ရရှိစေပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	densify_by_count(geometry, vertices)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု ((multi)linestrings သို့မဟုတ် (multi)polygons ကို လက်ခံပါသည်) vertices - ပေါင်းထည့်ရမည့် မျဉ်းဆစ်အရေအတွက် (မျဉ်းပိုင်းတစ်ခုလျှင်)
ဥပမာများ	geom_to_wkt(densify_by_count(geom_from_wkt('LINESTRING(1 1, 10 1)'), 3)) → LineString (1 1, 3.25 1, 5.5 1, 7.75 1, 10 1)

ထပ်မံဖတ်ရှုရန်- အရေအတွက်များများထည့်ခြင်း (Densify by count) algorithm

13.2.13.23. densify_by_distance

ဤ function သည် polygon သို့မဟုတ် line layer ဂျီဩမေတြီတစ်ခုကိုယူ၍ သတ်မှတ်ထားသော အများဆုံး ကြားပိုင်း အကွာအဝေး ရှိသည့် အစွန်းများတွင် မျဉ်းဆစ်များ ထပ်မံပေါင်းထည့်ခြင်းဖြင့် သိပ်သည်းအောင်ပြုလုပ်ထားသော ဂျီဩမေတြီအသစ်တစ်ခုကို ရရှိစေပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	densify_by_distance(geometry, distance)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု ((multi)linestrings သို့မဟုတ် (multi)polygons ကို လက်ခံပါသည်) distance - ရလာဒ်ဂျီဩမေတြီအတွင်း မျဉ်းဆစ်များအကြားရှိ အများဆုံး ကြားပိုင်း အကွာအဝေး
ဥပမာများ	geom_to_wkt(densify_by_distance(geom_from_wkt('LINESTRING(1 1, 10 1)'), 4)) → LineString (1 1, 4 1, 7 1, 10 1)

ထပ်မံဖတ်ရှုရန်- ကြားအကွာအဝေးတိုင်းတွင်ထည်ခြင်း (Densify by interval) algorithm

13.2.13.24. difference

ဤ function သည် ဂျီဩမေတြီ (၂) နှင့် ထိဖြတ်သွားခြင်းမရှိသော ဂျီဩမေတြီ (၁) ၏အစိတ်အပိုင်းများကို ကိုယ်စားပြုသည့် ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	difference(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( difference( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4)' ) ) ) → ‘LINESTRING(4 4, 5 5)’

ထပ်မံဖတ်ရှုရန်- ခြားနားချက် (Difference) algorithm

13.2.13.25. disjoint

ဤ function သည် ဂျီဩမေတြီများ တည်နေရာအရ တစ်ခုနှင့်တစ်ခု ထိစပ်ခြင်းရှိမရှိကို စစ်ဆေးပေးပါသည်။ အကယ်၍ ဂျီဩမေတြီများသည် တည်နေရာအရထိစပ်ခြင်းမရှိလျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	disjoint(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	disjoint( geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0 ))' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE disjoint( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'POINT(4 4)' )) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_disjoint

13.2.13.26. distance

ဤ function သည် ဂျီဩမေတြီနှစ်ခုအကြားရှိ (တည်နေရာရည်ညွှန်းစနစ်အပေါ်မူတည်၍) အနည်းဆုံးအကွာအဝေးကို အရိပ်ချစနစ်၏ယူနစ်များဖြင့် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	distance(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	distance( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'POINT(4 8)' ) ) → 4

13.2.13.27. distance_to_vertex

ဤ function သည် သတ်မှတ်ထားသည့် မျဉ်းဆစ်တစ်ခုသို့ ဂျီဩမေတြီတလျှောက်ရှိ အကွာအဝေးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	distance_to_vertex(geometry, vertex)
Argument များ	geometry - linestring ဂျီဩမေတြီတစ်ခု vertex - 0 မှ စတင်သည့် မျဉ်းဆစ်ညွှန်းကိန်းဖြစ်သည်။ အကယ်၍ တန်ဖိုးသည် အနှုတ်လက္ခဏာဖြစ်ပါက ရွေးချယ်ထားသည့် မျဉ်းဆစ်ညွှန်းကိန်းသည် ပကတိတန်ဖိုးမှ ၎င်း၏စုစုပေါင်းအရေအတွက်ကို နှုတ်ထားခြင်း ဖြစ်သည်။
ဥပမာများ	distance_to_vertex(geometry:=geom_from_wkt('LineString(0 0, 10 0, 10 10)'),vertex:=1) → 10.0

13.2.13.28. end_point

ဤ function သည် ဂျီဩမေတြီတစ်ခုမှ နောက်ဆုံး node (ဆုံမှတ်)ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	end_point(geometry)
Argument များ	geometry - ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(end_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)'))) → ‘Point (0 2)’

ထပ်မံဖတ်ရှုရန်- အလိုရှိရာ vertex များကို ထုတ်ယူခြင်း (Extract specific vertices) algorithm

13.2.13.29. exif_geotag

ဤ function သည် ဓာတ်ပုံဖိုင်တစ်ခု၏ exif geotag များမှ point ဂျီဩမေတြီတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	exif_geotag(path)
Argument များ	path - ဓာတ်ပုံဖိုင်လမ်းကြောင်း သို့မဟုတ် မြေပုံ layer ၏တန်ဖိုးတစ်ခုဖြစ်သည်။ အကယ်၍ မြေပုံ layer ၏တန်ဖိုးကို သတ်မှတ်ထားပါက ထို layer ၏ မူလဖိုင်အရင်းအမြစ်ကို အသုံးပြုသွားပါမည်။
ဥပမာများ	geom_to_wkt(exif_geotag('/my/photo.jpg')) → ‘Point (2 4)’

13.2.13.30. extend

ဤ function သည် linestring ဂျီဩမေတြီတစ်ခု၏ စမှတ်နှင့်ဆုံးမှတ်ကို သတ်မှတ်တန်ဖိုးအတိုင်း ထပ်မံတိုးချဲ့စေပါသည်။ Line များကို အစမျဉ်းပိုင်းနှင့် အဆုံးမျဉ်းပိုင်း၏ လားရာအတိုင်း တိုးချဲ့ခြင်းဖြစ်သည်။ Line များစွာပါရှိပါက ထိုမျဉ်းအစိတ်အပိုင်းများအားလုံးကို တိုးချဲ့ပေးမည်ဖြစ်ပြီး အကွာအဝေးများမှာ ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ်အတိုင်း ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	extend(geometry, start_distance, end_distance)
Argument များ	geometry - (multi)linestring ဂျီဩမေတြီ start_distance - မျဉ်း၏စမှတ်ကို တိုးချဲ့မည့်အကွာအဝေး end_distance -မျဉ်း၏ဆုံးမှတ်ကို တိုးချဲ့မည့်အကွာအ‌ဝေး
ဥပမာများ	geom_to_wkt(extend(geom_from_wkt('LineString(0 0, 1 0, 1 1)'),1,2)) → ‘LineString (-1 0, 1 0, 1 3)’ geom_to_wkt(extend(geom_from_wkt('MultiLineString((0 0, 1 0, 1 1), (2 2, 0 2, 0 5))'),1,2)) → ‘MultiLineString ((-1 0, 1 0, 1 3),(3 2, 0 2, 0 7))’

ထပ်မံဖတ်ရှုရန်- Line များကို ဆန့်ထုတ်ခြင်း (Extend lines) algorithm

13.2.13.31. exterior_ring

ဤ function သည် polygon ဂျီဩမေတြီတစ်ခု၏ အပြင်နယ်နိမိတ်ကို ကိုယ်စားပြုသော line တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ဂျီဩမေတြီသည် polygon တစ်ခုမဟုတ်ပါက ရလဒ်သည် NULL ဟူ၍ ဖော်ပြနေမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	exterior_ring(geometry)
Argument များ	geometry - polygon ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(exterior_ring(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),( 0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2, 0.1, 0.1 0.1))'))) → ‘LineString (-1 -1, 4 0, 4 2, 0 2, -1 -1)’

13.2.13.32. extrude

ဤ function သည် ထည့်သွင်းလိုက်သည့် မျဉ်းကွေး(များ) သို့မဟုတ် မျဉ်းကြောင်း(များ) ဂျီဩမေတြီများကို သတ်မှတ်ထားသည့် x နှင့် y တန်ဖိုးများဖြင့် တိုးချဲ့ပြီး ထုဖော်ထားသည့်ပုံစံကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	extrude(geometry, x, y)
Argument များ	geometry - မျဉ်းကွေး သို့မဟုတ် linestring ဂျီဩမေတြီ x - တိုးချဲ့သည့် x ဂဏန်းတန်ဖိုး y - တိုးချဲ့သည့် y ဂဏန်းတန်ဖိုး
ဥပမာများ	geom_to_wkt(extrude(geom_from_wkt('LineString(1 2, 3 2, 4 3)'), 1, 2)) → ‘Polygon ((1 2, 3 2, 4 3, 5 5, 4 4, 2 4, 1 2))’ geom_to_wkt(extrude(geom_from_wkt('MultiLineString((1 2, 3 2), (4 3, 8 3))'), 1, 2)) → ‘MultiPolygon (((1 2, 3 2, 4 4, 2 4, 1 2)),((4 3, 8 3, 9 5, 5 5, 4 3)))’

13.2.13.33. flip_coordinates

ဤ function သည် x နှင့် y ကိုဩဒိနိတ်များလဲလှယ်ပြောင်းလဲထားသော ဂျီဩမေတြီ၏မိတ္တူတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ လတ္တီကျု နှင့် လောင်ဂျီကျု တန်ဖိုးများ ပြောင်းပြန်ဖြစ်နေသော ဂျီဩမေတြီများကို ပြုပြင်ရာတွင် အသုံးဝင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	flip_coordinates(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(flip_coordinates(make_point(1, 2))) → ‘Point (2 1)’ geom_to_wkt(flip_coordinates(geom_from_wkt('LineString(0 2, 1 0, 1 6)'))) → ‘LineString (2 0, 0 1, 6 1)’

ထပ်မံဖတ်ရှုရန်- X နှင့် Y ကိုဩဒိနိတ်များကို နေရာဖလှယ်ခြင်း (Swap X and Y coordinates) algorithm

13.2.13.34. force_polygon_ccw

ဤ function သည် ဂျီဩမေတြီတစ်ခုကို ပြင်ပနယ်နိမိတ်ကွင်းများအား နာရီလက်တံပြောင်းပြန်အတိုင်းလည်းကောင်း၊ အတွင်းနယ်နိမိတ်ကွင်းများအား နာရီလက်တံအတိုင်းလည်းကောင်း ဖြစ်ရမည်ဟူသော သဘောတူညီချက်ကို လိုက်နာရန် လုပ်ဆောင်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	force_polygon_ccw(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု၊ polygon မဟုတ်သော ဂျီဩမေတြီများမှာမူ မပြောင်းလဲဘဲ မူလအတိုင်း ရှိနေမည်ဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(force_polygon_ccw(geometry:=geom_from_wkt('Polygon ((-1 -1, 0 2, 4 2, 4 0, -1 -1))'))) → ‘Polygon ((-1 -1, 4 0, 4 2, 0 2, -1 -1))’

ထပ်မံဖတ်ရှုရန်- force_polygon_cw ၊ force_rhr

13.2.13.35. force_polygon_cw

ဤ function သည် ဂျီဩမေတြီတစ်ခုကို ပြင်ပနယ်နိမိတ်ကွင်းများအား နာရီလက်တံအတိုင်းလည်းကောင်း၊ အတွင်းနယ်နိမိတ်ကွင်းများအား နာရီလက်တံပြောင်းပြန်အတိုင်းလည်းကောင်း ဖြစ်ရမည်ဟူသော သဘောတူညီချက်ကို လိုက်နာရန် လုပ်ဆောင်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	force_polygon_cw(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု၊ polygon မဟုတ်သော ဂျီဩမေတြီများမှာမူ မပြောင်းလဲဘဲ မူလအတိုင်း ရှိနေမည်ဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(force_polygon_cw(geometry:=geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'))) → ‘Polygon ((-1 -1, 0 2, 4 2, 4 0, -1 -1))’

ထပ်မံဖတ်ရှုရန်- force_polygon_ccw ၊ force_rhr

13.2.13.36. force_rhr

ဤ function သည် ဂျီဩမေတြီတစ်ခုကို Right-Hand-Rule (လက်ယာဘက်စည်းမျဉ်း) အတိုင်း လိုက်နာစေပါသည်။ လက်ယာဘက်စည်းမျဉ်းဆိုသည်မှာ polygon ဖြင့် ဘောင်ခတ်ထားသော ဧရိယာတစ်ခုသည် နယ်နိမိတ်၏လက်ယာဘက်လားရာအတိုင်း ဆောင်ရွက်စေခြင်းဖြစ်သည်။ အထူးသဖြင့် ပြင်ပနယ်နိမိတ်ကွင်းများသည် နာရီလက်တံလားရာအတိုင်းဖြစ်ပြီး အတွင်းနယ်နိမိတ်ကွင်းများမှာမူ နာရီလက်တံပြောင်းပြန်လားရာအတိုင်းဖြစ်သည်။ လက်ယာဘက်စည်းမျဉ်း သည် အချို့သော အကြောင်းအရာများအတွက် အဓိပ္ပါယ်သတ်မှတ်ချက် တသမတ်တည်း မရှိခြင်းကြောင့် တိကျပြတ်သားသော force_polygon_cw funcion ကို အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	force_rhr(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု၊ polygon မဟုတ်သော ဂျီဩမေတြီများမှာမူ မပြောင်းလဲဘဲ မူလအတိုင်း ရှိနေမည်ဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(force_rhr(geometry:=geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'))) → ‘Polygon ((-1 -1, 0 2, 4 2, 4 0, -1 -1))’

ထပ်မံဖတ်ရှုရန်- Right-hand-rule ကိုတွန်းအားပေးလုပ်ဆောင်ခြင်း (Force right-hand-rule) algorithm ၊ force_polygon_ccw ၊ force_polygon_cw

13.2.13.37. geom_from_gml

ဤ function သည် ဂျီဩမေတြီ၏ GML ကိုယ်စားပြုဖော်ပြခြင်းတစ်ခုမှ ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geom_from_gml(gml)
Argument များ	gml - ဂျီဩမေတြီတစ်ခု၏ GML ကို စာသားအနေဖြင့် ဖော်ပြခြင်း
ဥပမာများ	geom_from_gml('<gml:LineString srsName="EPSG:4326"><gml:coordinates>4,4 5,5 6,6</gml:coordinates></gml:LineString>') → line ဂျီဩမေတြီ object တစ်ခု

13.2.13.38. geom_from_wkb

ဤ function သည် Well-Known Binary (WKB) ကိုယ်စားပြုမှုတစ်ခုမှ ဖန်တီးထားသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geom_from_wkb(binary)
Argument များ	binary - ဂျီဩမေတြီတစ်ခု၏ လူသိများသော Well-Known Binary (WKB) ကိုယ်စားပြုမှု (binary blob တစ်ခုအဖြစ်)
ဥပမာများ	geom_from_wkb( geom_to_wkb( make_point(4,5) ) ) → point ဂျီဩမေတြီ object တစ်ခု

13.2.13.39. geom_from_wkt

ဤ function သည် Well-Known Text (WKT) ကိုယ်စားပြုမှုတစ်ခုမှ ဖန်တီးထားသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geom_from_wkt(text)
Argument များ	text - ဂျီဩမေတြီတစ်ခု၏ လူသိများသော Well-Known Text (WKT) ကိုယ်စားပြုမှု
ဥပမာများ	geom_from_wkt( 'POINT(4 5)' ) → ဂျီဩမေတြီတစ်ခု

13.2.13.40. geom_to_wkb

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ Well-Known Binary (WKB) ကိုယ်စားပြုမှုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geom_to_wkb(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkb( @geometry ) → ဂျီဩမေတြီတစ်ခုပါဝင်သည့် binary blob

13.2.13.41. geom_to_wkt

ဤ function သည် ဂျီဩမေတြီ၏ Well-Known Text (WKT) ကိုယ်စားပြု‌ဖော်ပြခြင်းကို SRID metadata မပါဝင်ပဲ ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geom_to_wkt(geometry, [precision=8]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု precision - ကိန်းဂဏန်းဆိုင်ရာ တိကျမှု
ဥပမာများ	geom_to_wkt( make_point(6, 50) ) → ‘POINT(6 50)’ geom_to_wkt(centroid(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))'))) → ‘POINT(0 0.66666667)’ geom_to_wkt(centroid(geom_from_wkt('Polygon((1 1, 0 0, -1 1, 1 1))')), 2) → ‘POINT(0 0.67)’

13.2.13.42. $geometry

ဤ function သည် လက်ရှိအသုံးပြုနေသော feature ၏ ဂျီဩမေတြီကို ပြန်ထုတ်ပေးပါသည်။ အခြားသော လုပ်ဆောင်ချက်များ ဆောင်ရွက်ရန် အသုံးပြုနိုင်ပါသည်။ WARNING (သတိပေးချက်) - ဤလုပ်ဆောင်ချက်သည် အပြစ်အနာအဆာပါဝင်နေပြီး ၎င်းတို့အစား @geometry variable ကို အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$geometry
ဥပမာများ	geom_to_wkt( $geometry ) → ‘POINT(6 50)’

13.2.13.43. geometry

ဤ function သည် feature ၏ ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geometry(feature)
Argument များ	feature - feature အရာဝတ္ထုတစ်ခု
ဥပမာများ	geometry( @feature ) → လက်ရှိအသုံးပြုနေသော feature ၏ ဂျီဩမေတြီ၊ @geometry ကို အသုံးပြုလျှင် ပိုမိုကောင်းမွန်ပါသည်။ geom_to_wkt( geometry( get_feature_by_id( 'streets', 1 ) ) ) → “streets” layer တွင် id 1 ရှိသော feature ၏ WKT ပုံစံဖြင့် ဂျီဩမေတြီ၊ ဥပမာ- ‘POINT(6 50)’ intersects( @geometry, geometry( get_feature( 'streets', 'name', 'Main St.' ) ) ) → “streets” layer ထဲရှိ ‘Main St.’ အမည်ရှိသော feature ကို လက်ရှိ feature မှ တည်နေရာအရ ထိဖြတ်သွားလျှင် TRUE ကိုပြန်ထုတ်ပေးပါသည်

13.2.13.44. geometry_n

ဤ function သည် ဂျီဩမေတြီစုစည်းမှုမှ သီးခြား ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပြီး အကယ်၍ ထည့်သွင်းလိုက်သော ဂျီဩမေတြီသည် စုစည်းမှု တစ်ခုမဟုတ်ပါက NULL ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ ၎င်းသည် အစိတ်အပိုင်းများစွာပါဝင်သော ဂျီဩမေတြီတစ်ခု အစိတ်အပိုင်းတစ်ခုကိုလည်း ပြန်ထုတ်ပေးနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	geometry_n(geometry, index)
Argument များ	geometry - ဂျီဩမေတြီစုစည်းမှု index - ရရှိလာမည့် ဂျီဩမေတြီ၏ အညွှန်းကိန်း ဖြစ်ပြီး၊ 1 သည် စုစည်းမှုထဲရှိ ပထမဆုံး ဂျီဩမေတြီဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(geometry_n(geom_from_wkt('GEOMETRYCOLLECTION(POINT(0 1), POINT(0 0), POINT(1 0), POINT(1 1))'),3)) → ‘Point (1 0)’

13.2.13.45. geometry_type

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အမျိုးအစားကို ဖော်ပြသော စာသားတန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါသည် (Point ၊ Line သို့မဟုတ် Polygon)

Syntax (ဝါကျဖွဲ့ပုံ)	geometry_type(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geometry_type( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → ‘Line’ geometry_type( geom_from_wkt( 'MULTILINESTRING((2 5, 3 6, 4 8), (1 1, 0 0))') ) → ‘Line’ geometry_type( geom_from_wkt( 'POINT(2 5)') ) → ‘Point’ geometry_type( geom_from_wkt( 'POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))') ) → ‘Polygon’

13.2.13.46. hausdorff_distance

ဤ function သည် ဂျီဩမေတြီနှစ်ခုကြားရှိ Hausdorff အကွာအဝေးကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် အခြေခံအားဖြင့် ဂျီဩမေတြီနှစ်ခု မည်သို့မည်ပုံ ဆင်တူခြင်း/ကွဲပြားခြင်းကို တိုင်းတာခြင်းဖြစ်ပါသည်။ အကွာအဝေးနည်းလေလေ ဂျီဩမေတြီနှစ်ခုမှာ ပိုမိုဆင်တူလေဖြစ်ပါသည်။

ဤ function ကို optional ဖြစ်သော densify fraction argument ဖြင့် စေခိုင်းလုပ်ဆောင်နိုင်ပါသည်။ အကယ်၍ သီးခြားသတ်မှတ်ထားခြင်းမရှိပါက စံသတ်မှတ်ထားသော Hausdorff အကွာအဝေး နှင့် အနီးစပ်ဆုံး တန်ဖိုးကို အသုံးပြုသွားမည်ဖြစ်ပါသည်။ ဤအနီးစပ်ဆုံးတန်ဖိုးမှာ အသုံးဝင်သော ဖြစ်ရပ်များစွာအတွက် တန်ဖိုးအတိအကျ သို့မဟုတ် အနီးစပ်ဆုံးတန်ဖိုးဖြစ်ပါသည်။ ဥပမာများမှာ-

• တစ်ခုနှင့် တစ်ခု အကြမ်းဖျင်းအားဖြင့် အလျားတူပြီး ပြိုင်နေသည့် မျဉ်းကြောင်းများအကြား အကွာအဝေးကို တွက်ချက်ခြင်း။ ၎င်းသည် မျဉ်းဖြောင့် လမ်းကြောင်းကွန်ယက်များကို ယှဉ်တွဲသည့်အခါ တွေ့ရပါသည်။

• ဂျီဩမေတြီများ၏ ဆင်တူမှုကို စမ်းသပ်ခြင်း။

အကယ်၍ ဤနည်းလမ်းဖြင့် ပံ့ပိုးပေးထားသော default အနီးစပ်ဆုံးတန်ဖိုးမှာ လုံလောက်မှုမရှိလျှင် optional ဖြစ်သော densify fraction argument ကို သတ်မှတ်ပါ။ ဤ argument ကို သတ်မှတ်ခြင်းအားဖြင့် Hausdorff အကွာအဝေး ပြတ်ကိန်းကို မတွက်ချက်မီ မျဉ်းပိုင်းများ တိုးခြင်း/သိပ်သည်းစေခြင်းကို ဆောင်ရွက်ပေးပါသည်။ Parameter သည် မျဉ်းပိုင်းတစ်ခုစီကို သိပ်သည်းအောင်လုပ်မည့် အပိုင်း (fraction) ကို သတ်မှတ်ပေးပါသည်။ မျဉ်းပိုင်းတစ်ခုစီအား အလျားတူညီသော မျဉ်းပိုင်းအခွဲများအဖြစ် ပိုင်းခြားသွားမည်ဖြစ်ပြီး အလျားစုစုပေါင်း၏ အပိုင်း (fraction) သည် ပေးထားသော အပိုင်း (fraction) နှင့် အနီးစပ်ဆုံးတူညီနေပါမည်။ densify fraction parameter ကိုလျော့ချလိုက်ပါက ပြန်လည်ရရှိလာမည့်အကွာအဝေးသည် ဂျီဩမေတြီများအတွက် Hausdorff အကွာအဝေးအမှန်နှင့် နီးစပ်လာစေမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hausdorff_distance(geometry1, geometry2, [densify_fraction]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု densify_fraction - သိပ်သည်းစေမည့် အပိုင်း အရေအတွက်
ဥပမာများ	hausdorff_distance( geometry1:= geom_from_wkt('LINESTRING (0 0, 2 1)'),geometry2:=geom_from_wkt('LINESTRING (0 0, 2 0)')) → 2 hausdorff_distance( geom_from_wkt('LINESTRING (130 0, 0 0, 0 150)'),geom_from_wkt('LINESTRING (10 10, 10 150, 130 10)')) → 14.142135623 hausdorff_distance( geom_from_wkt('LINESTRING (130 0, 0 0, 0 150)'),geom_from_wkt('LINESTRING (10 10, 10 150, 130 10)'),0.5) → 70.0

13.2.13.47. inclination

ဤ function သည် point_a တွင် ဦးထိပ်တည့်တည့်အမှတ် (zenith) (0) မှ အပေါ်အောက်တည့်အနေအထား (nadir) (180) ဖြင့် point_b သို့ တိုင်းတာသော စောင်းခြင်း/အစောင်း ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	inclination(point_a, point_b)
Argument များ	point_a - point ဂျီဩမေတြီ point_b - point ဂျီဩမေတြီ
ဥပမာများ	inclination( make_point( 5, 10, 0 ), make_point( 5, 10, 5 ) ) → 0.0 inclination( make_point( 5, 10, 0 ), make_point( 5, 10, 0 ) ) → 90.0 inclination( make_point( 5, 10, 0 ), make_point( 50, 100, 0 ) ) → 90.0 inclination( make_point( 5, 10, 0 ), make_point( 5, 10, -5 ) ) → 180.0

13.2.13.48. interior_ring_n

ဤ function သည် polygon ဂျီဩမေတြီတစ်ခုမှ သီးခြား အတွင်းနယ်နိမိတ်ကွင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ သို့မဟုတ် အကယ်၍ ဂျီဩမေတြီသည် polygon မဟုတ်ပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	interior_ring_n(geometry, index)
Argument များ	geometry - polygon ဂျီဩမေတြီ index - ပြန်လည်ရရှိလာမည့် အတွင်းနယ်နိမိတ်ကွင်း၏အညွှန်းကိန်းဖြစ်ပြီး 1 သည် ပထမဆုံး အတွင်းနယ်နိမိတ်ကွင်းဖြစ်ပါသည်။
ဥပမာများ	geom_to_wkt(interior_ring_n(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1),(-1 -1, 4 0, 4 2, 0 2, -1 -1))'),1)) → ‘LineString (-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))’

13.2.13.49. intersection

ဤ function သည် ဂျီဩမေတြီနှစ်ခု၏ ထိဖြတ်နေသော အပိုင်းကို ကိုယ်စားပြုသည့် ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	intersection(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( intersection( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4)' ) ) ) → ‘LINESTRING(3 3, 4 4)’ geom_to_wkt( intersection( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'MULTIPOINT(3.5 3.5, 4 5)' ) ) ) → ‘POINT(3.5 3.5)’

ထပ်မံဖတ်ရှုရန်- ထိဖြတ်ခြင်း (Intersection) algorithm

13.2.13.50. intersects

ဤ function သည် ဂျီဩမေတြီတစ်ခုသည် အခြားတစ်ခုနှင့် ထိဖြတ်ခြင်းရှိ/မရှိကို စစ်ဆေးပေးပါသည်။ ဂျီဩမေတြီများသည် တည်နေရာအားဖြင့် ထိဖြတ်နေလျှင် (နေရာအပိုင်းတစ်ခုခုကို ဝေမျှပိုင်ဆိုင်ထားလျှင်) TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး မထိဖြတ်နေကြလျှင် false ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	intersects(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	intersects( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE intersects( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'POINT(5 5)' ) ) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_intersects

13.2.13.51. intersects_bbox

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) သည် အခြား ဂျီဩမေတြီတစ်ခု၏ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) နှင့် ထပ်နေခြင်း ရှိ/မရှိ စစ်ဆေးပေးပါသည်။ အကယ်၍ ဂျီဩမေတြီများသည် သတ်မှတ်ထားသော စတုဂံပုံအကျယ်အဝန်းနယ်တွင် တည်နေရာအရ ထိဖြတ်နေလျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး ထိဖြတ်မနေပါက false ကို ပြန်ထုတ်ပေးမည် ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	intersects_bbox(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	intersects_bbox( geom_from_wkt( 'POINT(4 5)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE intersects_bbox( geom_from_wkt( 'POINT(6 5)' ), geom_from_wkt( 'POLYGON((3 3, 4 4, 5 5, 3 3))' ) ) → FALSE

13.2.13.52. is_closed

ဤ funcion သည် မျဉ်းကြောင်းတစ်ကြောင်း (line string) သည် မျဉ်းပိတ်ဖြစ်နေလျှင် (စမှတ် နှင့် ဆုံးမှတ်သည် ထိစပ်နေလျှင်) TRUE ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ မျဉ်းကြောင်းသည် မျဉ်းပိတ်ဖြစ်မနေပါက false ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ အကယ်၍ ဂျီဩမေတြီသည် မျဉ်းတစ်ကြောင်း မဟုတ်ပါက ရလဒ်သည် NULL ဖြစ်နေပေလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_closed(geometry)
Argument များ	geometry - line string ဂျီဩမေတြီတစ်ခု
ဥပမာများ	is_closed(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → FALSE is_closed(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2, 0 0)')) → TRUE

13.2.13.53. is_empty

ဤ function သည် ကိုဩဒိနိတ်စနစ်များမပါရှိသော ဂျီဩမေတြီတစ်ခု ဖြစ်နေလျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး အကယ်၍ ကိုဩဒိနိတ်စနစ်များပါရှိနေသော ဂျီဩမေတြီတစ်ခုဖြစ်ပါက false ကို ပြန်ထုတ်ပေးပါမည်။ ဂျီဩမေတြီမရှိပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ is_empty_or_null ကိုလည်း ကြည့်ရှုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_empty(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	is_empty(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → FALSE is_empty(geom_from_wkt('LINESTRING EMPTY')) → TRUE is_empty(geom_from_wkt('POINT(7 4)')) → FALSE is_empty(geom_from_wkt('POINT EMPTY')) → TRUE

ထပ်မံဖတ်ရှုရန်- is_empty_or_null

13.2.13.54. is_empty_or_null

ဤ function သည် ဂျီဩမေတြီတစ်ခုသည် NULL သို့မဟုတ် ကိုဩဒိနိတ်မပါရှိလျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး ယင်းသို့မဟုတ်ပါက false ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ ဤ function သည် ‘@geometry IS NULL or is_empty(@geometry)’ ဟူသော expression ကဲ့သို့ပင် ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_empty_or_null(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	is_empty_or_null(NULL) → TRUE is_empty_or_null(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)')) → FALSE is_empty_or_null(geom_from_wkt('LINESTRING EMPTY')) → TRUE is_empty_or_null(geom_from_wkt('POINT(7 4)')) → FALSE is_empty_or_null(geom_from_wkt('POINT EMPTY')) → TRUE

ထပ်မံဖတ်ရှုရန်- is_empty ၊ NULL

13.2.13.55. is_multipart

ဤ function သည် ဂျီဩမေတြီတစ်ခုတွင် အစိတ်အပိုင်းများစွာပါဝင်သော အမျိုးအစားဖြစ်ပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_multipart(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	is_multipart(geom_from_wkt('MULTIPOINT ((0 0),(1 1),(2 2))')) → TRUE is_multipart(geom_from_wkt('POINT (0 0)')) → FALSE

13.2.13.56. is_valid

ဤ function တွင် ဂျီဩမေတြီတစ်ခုသည် OGC စည်းမျဉ်းများအရ နှစ်ဖက်မြင်ပုံစံဖြင့် ကောင်းစွာတည်ဆောက်ထားပြီး ခိုင်လုံမှုရှိပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_valid(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	is_valid(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2, 0 0)')) → TRUE is_valid(geom_from_wkt('LINESTRING(0 0)')) → FALSE

ထပ်မံဖတ်ရှုရန်- make_valid ၊ အရည်အသွေးစစ်ဆေးခြင်း (Check validity) algorithm

13.2.13.57. $length

ဤ function သည် မျဉ်းကြောင်းတစ်ကြောင်း၏ အလျားကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ polygon တစ်ခု၏ နယ်နိမိတ်မျဉ်းအလျားကို သိလိုလျှင် ဤ function အစား $perimeter ကို အသုံးပြုပါ။ ဤ function ဖြင့် တွက်ချက်ရရှိသော အလျားသည် လက်ရှိ project ၏ စက်လုံးပုံ (ellipsoid) setting နှင့် အကွာအဝေးယူနစ် setting နှစ်မျိုးစလုံးအတိုင်း ဖြစ်ပါသည်။ ဥပမာအားဖြင့် project ကို စက်လုံးပုံ (ellipsoid) အဖြစ် သတ်မှတ်ထားပါက တွက်ချက်မှုမှရရှိလာသောအလျားသည် ellipsoidal ဖြစ်နေမည်ဖြစ်ပြီး စက်လုံးပုံ (ellipsoid) ကိုသတ်မှတ်မထားပါက တွက်ချက်ရရှိသော အလျားသည် ပြင်ညီအလျား (planimetric) ဖြစ်နေပေလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$length
ဥပမာများ	$length → 42.4711

13.2.13.58. length

ဤ function သည် စာသားတစ်ခုထဲရှိ စာလုံးအရေအတွက် သို့မဟုတ် linestring ဂျီဩမေတြီတစ်ခု၏ အလျားကို ပြန်ထုတ်ပေးပါသည်။

String variant (စာသား မူကွဲ)

စာသားတစ်ခုထဲရှိ စာလုံးအရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	length(string)
Argument များ	string - စာလုံးအရေအတွက်ကို တွက်ချက်မည့် စာသား
ဥပမာများ	length('hello') → 5

Geometry variant (ဂျီဩမေတြီ မူကွဲ)

ဤ function သည် line ဂျီဩမေတြီတစ်ခု၏ အလျားကို တွက်ချက်ပေးပါသည်။ တွက်ချက်မှုများကို ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) ရှိ ပြင်ညီအတိုင်း တွက်ချက်ပြီး ရရှိလာသော အလျား၏ ယူနစ်များသည် ထို SRS ၏ ယူနစ်များနှင့် ကိုက်ညီနေမည်ဖြစ်သည်။ $length funcion နှင့် မတူညီသည့်အချက်မှာ $length သည် project ၏ စက်လုံးပုံ (ellipsoid) နှင့် အကွာအဝေးယူနစ် setting များအတိုင်း စက်လုံးဆိုင်ရာ (ellipsoidal) တွက်ချက်မှုများကို ပြုလုပ်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	length(geometry)
Argument များ	geometry - line ဂျီဩမေတြီ
ဥပမာများ	length(geom_from_wkt('LINESTRING(0 0, 4 0)')) → 4.0

ထပ်မံဖတ်ရှုရန်- straight_distance_2d

13.2.13.59. length3D

ဤ function သည် line ဂျီဩမေတြီတစ်ခု၏ 3D အလျားကို တွက်ချက်ပေးပါသည်။ ဂျီဩမေတြီသည် 3D line အရာဝတ္ထုမဟုတ်ပါက 2D အလျားကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ တွက်ချက်မှုများကို ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) ရှိ ပြင်ညီအတိုင်း တွက်ချက်ပြီး ရရှိလာသော အလျား၏ ယူနစ်များသည် ထို SRS ၏ ယူနစ်များနှင့် ကိုက်ညီနေမည်ဖြစ်သည်။ $length function မှ ရရှိလာသည့် တွက်ချက်မှုများနှင့် မတူညီသည့်အချက်မှာ $length သည် project ၏ စက်လုံးပုံ (ellipsoid) နှင့် အကွာအဝေးယူနစ် setting များအတိုင်း စက်လုံးဆိုင်ရာ (ellipsoidal) တွက်ချက်မှုများကို ပြုလုပ်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	length3D(geometry)
Argument များ	geometry - line ဂျီဩမေတြီ
ဥပမာများ	length3D(geom_from_wkt('LINESTRINGZ(0 0 0, 3 0 4)')) → 5.0

13.2.13.60. line_interpolate_angle

ဤ function သည် linestring ဂျီဩမေတြီတစ်လျှောက် သတ်မှတ်ထားသော အကွာအဝေးတစ်ခု၌ ထိုဂျီဩမေတြီနှင့် အပြိုင် ထောင့်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ ထောင့်များသည် မြောက်အရပ်မှ နာရီလက်တံအတိုင်း ဒီဂရီဖြင့် တိုင်းတာခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	line_interpolate_angle(geometry, distance)
Argument များ	geometry - linestring ဂျီဩမေတြီတစ်ခု distance - ထောင့်တွက်ထုတ်ပေးမည့် line တလျှောက်အကွာအဝေး
ဥပမာများ	line_interpolate_angle(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),distance:=5) → 90.0

13.2.13.61. line_interpolate_point

ဤ function သည် linestring ဂျီဩမေတြီတစ်ခုတလျှောက်တွင် သတ်မှတ်ထားသည့် အကွာအဝေး၌ တွက်ထုတ်ထားသည့် point ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	line_interpolate_point(geometry, distance)
Argument များ	geometry - linestring ဂျီဩမေတြီတစ်ခု distance - line တလျှောက် တွက်ထုတ်မည့် အကွာအဝေး
ဥပမာများ	geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 8 0)'), distance:=5)) → ‘Point (5 0)’ geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 1 1, 2 0)'), distance:=2.1)) → ‘Point (1.48492424 0.51507576)’ geom_to_wkt(line_interpolate_point(geometry:=geom_from_wkt('LineString(0 0, 1 0)'), distance:=2)) → NULL

ထပ်မံဖတ်ရှုရန်- မျဉ်းပေါ်တွင်အမှတ်များကိုတွက်ချက်နေရာချထားခြင်း (Interpolate point on line) algorithm

13.2.13.62. line_locate_point

ဤ function သည် သတ်မှတ်ထားသည့် point ဂျီဩမေတြီတစ်ခုဆီသို့ linestring မှအနီးစပ်ဆုံးတည်နေရာနှင့် သက်ဆိုင်သည့် linestring တလျှောက် အကွာအ‌ဝေးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	line_locate_point(geometry, point)
Argument များ	geometry - linestring ဂျီဩမေတြီတစ်ခု point - linestring ပေါ်မှ အနီးစပ်ဆုံးတည်နေရာကို ညွှန်ပြပေးမည့် point ဂျီဩမေတြီ
ဥပမာများ	line_locate_point(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),point:=geom_from_wkt('Point(5 0)')) → 5.0

13.2.13.63. line_merge

ဤ function သည် ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီမှ ချိတ်ဆက်နေသည့် မျဉ်းကြောင်းများကို မျဉ်းကြောင်းတစ်ခုတည်းအဖြစ် ပေါင်းစည်းထားသော LineString ဂျီဩမေတြီတစ်ခု သို့မဟုတ် MultiLineString ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ ဤ function သည် အကယ်၍ LineString/MultiLineString ဂျီဩမေတြီတစ်ခုကို မဟုတ်ပါက Null ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	line_merge(geometry)
Argument များ	geometry - LineString/MultiLineString ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(line_merge(geom_from_wkt('MULTILINESTRING((0 0, 1 1),(1 1, 2 2))'))) → ‘LineString(0 0,1 1,2 2)’ geom_to_wkt(line_merge(geom_from_wkt('MULTILINESTRING((0 0, 1 1),(11 1, 21 2))'))) → ‘MultiLineString((0 0, 1 1),(11 1, 21 2)’

13.2.13.64. line_substring

ဤ function သည် သတ်မှတ်ထားသည့် စမှတ်နှင့်ဆုံးမှတ်အကြား အကွာအဝေး (မျဉ်းကြောင်းအစမှ တိုင်းတာထားသော) အတွင်း ကျရောက်သည့် မျဉ်းကြောင်း(သို့မဟုတ် မျဉ်းကွေး) ၏ အပိုင်းတစ်ခု ကို ပြန်ထုတ်ပေးပါသည်။ Z နှင့် M တန်ဖိုးများကို ရှိပြီးသားတန်ဖိုးများမှ linear (အစဉ်လိုက်) အတိုင်း ဖြည့်စွက်တွက်ချက် (interpolate) ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	line_substring(geometry, start_distance, end_distance)
Argument များ	geometry - မျဉ်းကြောင်း သို့မဟုတ် မျဉ်းကွေး ဂျီဩမေတြီတစ်ခု start_distance - မျဉ်းအခွဲ၏ စမှတ်သို့ အကွာအဝေး end_distance - မျဉ်းအခွဲ၏ ဆုံးမှတ်သို့ အကွာအဝေး
ဥပမာများ	geom_to_wkt(line_substring(geometry:=geom_from_wkt('LineString(0 0, 10 0)'),start_distance:=2,end_distance:=6)) → ‘LineString (2 0,6 0)’

ထပ်မံဖတ်ရှုရန်- Line တစ်စိတ်တစ်ပိုင်း (Line substring) algorithm

13.2.13.65. m

ဤ function သည် point ဂျီဩမေတြီတစ်ခု၏ m (အတိုင်းအတာ) တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	m(geometry)
Argument များ)	geometry - point ဂျီဩမေတြီတစ်ခု
ဥပမာများ	m( geom_from_wkt( 'POINTM(2 5 4)' ) ) → 4

13.2.13.66. m_at

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ m ကိုဩဒိနိတ်ကို ရယူပေးပါသည်။ သို့မဟုတ် ထိုဂျီဩမေတြီတွင် m တန်ဖိုးမရှိပါက NULL ကို ရရှိမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	m_at(geometry, vertex)
Argument များ	geometry - ဂျီဩမေတြီ vertex - ဂျီဩမေတြီ၏ မျဉ်းအဆစ်ညွှန်းကိန်း (အညွှန်းကိန်းများသည် 0 မှ စတင်ပါသည်၊ အနုတ်တန်ဖိုးများကို နောက်ဆုံးအညွှန်းကိန်းမှ စတင်လျှင်အသုံးပြုပြီး -1 မှ စတင်သည်)
ဥပမာများ	m_at(geom_from_wkt('LineStringZM(0 0 0 0, 10 10 0 5, 10 10 0 0)'), 1) → 5

13.2.13.67. m_max

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အများဆုံး m (အတိုင်းအတာ) တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	m_max(geometry)
Argument များ	geometry - m တန်ဖိုးများပါဝင်သော ဂျီဩမေတြီတစ်ခု
ဥပမာများ	m_max( make_point_m( 0,0,1 ) ) → 1 m_max(make_line( make_point_m( 0,0,1 ), make_point_m( -1,-1,2 ), make_point_m( -2,-2,0 ) ) ) → 2

13.2.13.68. m_min

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အနည်းဆုံး m(အတိုင်းအတာ) တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	m_min(geometry)
Argument များ	geometry - m တန်ဖိုးများပါဝင်သော ဂျီဩမေတြီတစ်ခု
ဥပမာများ	m_min( make_point_m( 0,0,1 ) ) → 1 m_min(make_line( make_point_m( 0,0,1 ), make_point_m( -1,-1,2 ), make_point_m( -2,-2,0 ) ) ) → 0

13.2.13.69. main_angle

ဤ function သည် ဂျီဩမေတြီကို လုံးလုံးလျားလျားဖုံးအုပ်သော အသေးဆုံးထောင့်မှန်စတုဂံပုံ အကျယ်အဝန်းနယ်၏ ရှည်သောဝင်ရိုး (မြောက်အရပ်မှ နာရီလက်တံအတိုင်းတိုင်းတာသည့် ထောင့်ဒီဂရီ) ၏ ထောင့်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	main_angle(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	main_angle(geom_from_wkt('Polygon ((321577 129614, 321581 129618, 321585 129615, 321581 129610, 321577 129614))')) → 38.66

13.2.13.70. make_circle

ဤ funcion သည် စက်ဝိုင်းပုံ polygon တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_circle(center, radius, [segments=36]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	center - စက်ဝိုင်း၏ အလယ်မှတ် radius - စက်ဝိုင်း၏ အချင်းဝက် segments - Polygon မျဉ်းပိုင်းများအတွက် optional ဖြစ်သော argument ဖြစ်သည်။ Default အားဖြင့် ဤတန်ဖိုးမှာ 36 ဖြစ်သည်
ဥပမာများ	geom_to_wkt(make_circle(make_point(10,10), 5, 4)) → ‘Polygon ((10 15, 15 10, 10 5, 5 10, 10 15))’ geom_to_wkt(make_circle(make_point(10,10,5), 5, 4)) → ‘PolygonZ ((10 15 5, 15 10 5, 10 5 5, 5 10 5, 10 15 5))’ geom_to_wkt(make_circle(make_point(10,10,5,30), 5, 4)) → ‘PolygonZM ((10 15 5 30, 15 10 5 30, 10 5 5 30, 5 10 5 30, 10 15 5 30))’

13.2.13.71. make_ellipse

ဤ function သည် ဘဲဥပုံ polygon တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_ellipse(center, semi_major_axis, semi_minor_axis, azimuth, [segments=36]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	center - ဘဲဥပုံ၏ အလယ်မှတ် semi_major_axis - ဘဲဥပုံ၏ semi-major (တစ်ပိုင်းတစ်စအဓိကဖြစ်သော) ဝင်ရိုး semi_minor_axis - ဘဲဥပုံ၏ semi-minor (တစ်ပိုင်းတစ်စအသေးအဖွဲဖြစ်သော) ဝင်ရိုး azimuth - ဘဲဥပုံ၏ဦးတည်ရာ segments - Polygon မျဉ်းပိုင်းများအတွက် optional ဖြစ်သော argument ဖြစ်သည်။ Default အားဖြင့် ဤတန်ဖိုးမှာ 36 ဖြစ်သည်
ဥပမာများ	geom_to_wkt(make_ellipse(make_point(10,10), 5, 2, 90, 4)) → ‘Polygon ((15 10, 10 8, 5 10, 10 12, 15 10))’ geom_to_wkt(make_ellipse(make_point(10,10,5), 5, 2, 90, 4)) → ‘PolygonZ ((15 10 5, 10 8 5, 5 10 5, 10 12 5, 15 10 5))’ geom_to_wkt(make_ellipse(make_point(10,10,5,30), 5, 2, 90, 4)) → ‘PolygonZM ((15 10 5 30, 10 8 5 30, 5 10 5 30, 10 12 5 30, 15 10 5 30))’

13.2.13.72. make_line

ဤ function သည် point ဂျီဩမေတြီ စီးရီး (series) တစ်ခုမှ line ဂျီဩမေတြီတစ်ခုကို ဖန်တီးပေးပါသည်။

List of arguments variant (Argument မူကွဲများစာရင်း)

ဤ function ကို အသုံးပြုရာတွင် Line မျဉ်းအဆစ်များကို သီးခြား argument များအဖြစ် သတ်မှတ်ထားပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_line(point1, point2, …)
Argument များ	point - point ဂျီဩမေတြီ (သို့မဟုတ် point များ array)
ဥပမာများ	geom_to_wkt(make_line(make_point(2,4),make_point(3,5))) → ‘LineString (2 4, 3 5)’ geom_to_wkt(make_line(make_point(2,4),make_point(3,5),make_point(9,7))) → ‘LineString (2 4, 3 5, 9 7)’

Array variant (Array မူကွဲ)

Line မျဉ်းအဆစ်များကို point များ array တစ်ခုအဖြစ် သတ်မှတ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_line(array)
Argument များ	array - point များ array
ဥပမာများ	geom_to_wkt(make_line(array(make_point(2,4),make_point(3,5),make_point(9,7)))) → ‘LineString (2 4, 3 5, 9 7)’

13.2.13.73. make_point

ဤ function သည် x နှင့် y (optional ဖြစ်သော z နှင့် m) တန်ဖိုးတစ်ခုမှ point ဂျီဩမေတြီတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_point(x, y, [z], [m]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	x - Point ၏ x ကိုဩဒိနိတ် y - Point ၏ y ကိုဩဒိနိတ် z - optional ဖြစ်သော Point ၏ z ကိုဩဒိနိတ် m - optional ဖြစ်သော Point ၏ m ကိုဩဒိနိတ်
ဥပမာများ	geom_to_wkt(make_point(2,4)) → ‘Point (2 4)’ geom_to_wkt(make_point(2,4,6)) → ‘PointZ (2 4 6)’ geom_to_wkt(make_point(2,4,6,8)) → ‘PointZM (2 4 6 8)’

13.2.13.74. make_point_m

ဤ function သည် x ၊ y ကိုဩဒိနိတ်နှင့် m တန်ဖိုးတစ်ခုမှ point ဂျီဩမေတြီတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_point_m(x, y, m)
Argument များ	x - Point ၏ x ကိုဩဒိနိတ် y - Point ၏ y ကိုဩဒိနိတ် m - Point ၏ m တန်ဖိုး
ဥပမာများ	geom_to_wkt(make_point_m(2,4,6)) → ‘PointM (2 4 6)’

13.2.13.75. make_polygon

ဤ function သည် အပြင်နယ်နိမိတ်ကွင်းတစ်ခုနှင့် optional ဖြစ်သော အတွင်းနယ်နိမိတ်ကွင်း စီးရီးများ ပါဝင်သည့် ဂျီဩမေတြီများမှ polygon ဂျီဩမေတြီတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_polygon(outerRing, [innerRing1], [innerRing2], …) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	outerRing - Polygon ၏အပြင်နယ်နိမိတ်ကွင်းအတွက် အပိတ်ဖြစ်နေသော line ဂျီဩမေတြီ innerRing - Optional ဖြစ်သည့် အတွင်းနယ်နိမိတ်ကွင်းအတွက် အပိတ်ဖြစ်နေသော line ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(make_polygon(geom_from_wkt('LINESTRING( 0 0, 0 1, 1 1, 1 0, 0 0 )'))) → ‘Polygon ((0 0, 0 1, 1 1, 1 0, 0 0))’ geom_to_wkt(make_polygon(geom_from_wkt('LINESTRING( 0 0, 0 1, 1 1, 1 0, 0 0 )'),geom_from_wkt('LINESTRING( 0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2 0.1, 0.1 0.1 )'),geom_from_wkt('LINESTRING( 0.8 0.8, 0.8 0.9, 0.9 0.9, 0.9 0.8, 0.8 0.8 )'))) → ‘Polygon ((0 0, 0 1, 1 1, 1 0, 0 0),(0.1 0.1, 0.1 0.2, 0.2 0.2, 0.2 0.1, 0.1 0.1),(0.8 0.8, 0.8 0.9, 0.9 0.9, 0.9 0.8, 0.8 0.8))’

13.2.13.76. make_rectangle_3points

ဤ function သည် point သုံးခုမှ ထောင့်မှန်စတုဂံတစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_rectangle_3points(point1, point2, point3, [option=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	point1 - ပထမ point point2 - ဒုတိယ point point3 - တတိယ point option - ထောင့်မှန်စတုဂံတည်ဆောက်ရန် optional argument တစ်ခုဖြစ်သည်။ Default အားဖြင့် ထိုတန်ဖိုးမှာ 0 ဖြစ်ပါသည်။ တန်ဖိုးမှာ 0 (distance) သို့မဟုတ် 1 (projected) ဖြစ်နိုင်ပါသည်။ ရွေးချယ်မှု distance - ဒုတိယအကွာအဝေးသည် ဒုတိယမြောက် point နှင့် တတိယမြောက် point အကြား အကွာအဝေးနှင့် အတူတူပင်ဖြစ်သည်။ ရွေးချယ်မှု projected - ဒုတိယအကွာအဝေးသည် မျဉ်းပိုင်း သို့မဟုတ် တိုးချဲ့သည့်မျဉ်းပေါ်ရှိ တတိယမြောက် point အပေါ်တွင် ထောင့်မှန်ကျ ပုံရိပ်ချအကွာအဝေးနှင့် အတူတူပင်ဖြစ်သည်။
ဥပမာများ	geom_to_wkt(make_rectangle_3points(make_point(0, 0), make_point(0,5), make_point(5, 5), 0)) → ‘Polygon ((0 0, 0 5, 5 5, 5 0, 0 0))’ geom_to_wkt(make_rectangle_3points(make_point(0, 0), make_point(0,5), make_point(5, 3), 1)) → ‘Polygon ((0 0, 0 5, 5 5, 5 0, 0 0))’

13.2.13.77. make_regular_polygon

ဤ function သည် အနားညီ polygon တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_regular_polygon(center, radius, number_sides, [circle=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	center - အနားညီ polygon ၏ အလယ်မှတ် radius - ဒုတိယမြောက် point ဖြစ်သည်။ အကယ်၍ အနားညီ polygon သည် စက်ဝိုင်းအတွင်း ဝန်းထိခြင်း (inscribed) ဖြစ်နေပါက ပထမ point ဖြစ်သည်။ အနားညီ‌ polygon သည် စက်ဝိုင်းအပြင်တွင် ဝန်းထိခြင်း (circumscribed) များဖြစ်နေပါက ပထမအနား၏ အလယ်မှတ်ဖြစ်သည်။ number_sides - အနားညီ polygon ၏ အနားများ/အစွန်းများ အရေအတွက် circle - အနားညီ polygon ကို တည်ဆောက်ရန် optional ဖြစ်သော argument ဖြစ်သည်။ Default အားဖြင့် တန်ဖိုးမှာ 0 ဖြစ်သည်။ ထိုတန်ဖိုးသည် 0 (inscribed) သို့မဟုတ် 1 (circumscribed) ဖြစ်နိုင်သည်။
ဥပမာများ	geom_to_wkt(make_regular_polygon(make_point(0,0), make_point(0,5), 5)) → ‘Polygon ((0 5, 4.76 1.55, 2.94 -4.05, -2.94 -4.05, -4.76 1.55, 0 5))’ geom_to_wkt(make_regular_polygon(make_point(0,0), project(make_point(0,0), 4.0451, radians(36)), 5)) → ‘Polygon ((0 5, 4.76 1.55, 2.94 -4.05, -2.94 -4.05, -4.76 1.55, 0 5))’

13.2.13.78. make_square

ဤ function သည် ထောင့်ဖြတ်မျဉ်းတစ်ခုမှ စတုရန်းတစ်ခုဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_square(point1, point2)
Argument များ	point1 - ထောင့်ဖြတ်မျဉ်း၏ ပထမ point point2 - ထောင့်ဖြတ်မျဉ်း၏ ဒုတိယ point
ဥပမာများ	geom_to_wkt(make_square( make_point(0,0), make_point(5,5))) → ‘Polygon ((0 0, -0 5, 5 5, 5 0, 0 0))’ geom_to_wkt(make_square( make_point(5,0), make_point(5,5))) → ‘Polygon ((5 0, 2.5 2.5, 5 5, 7.5 2.5, 5 0))’

13.2.13.79. make_triangle

ဤ function သည် တြိဂံပုံ polygon တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_triangle(point1, point2, point3)
Argument များ	point1 - တြိဂံ၏ ပထမ point point2 - တြိဂံ၏ ဒုတိယ point point3 - တြိဂံ၏ တတိယ point
ဥပမာများ	geom_to_wkt(make_triangle(make_point(0,0), make_point(5,5), make_point(0,10))) → ‘Triangle ((0 0, 5 5, 0 10, 0 0))’ geom_to_wkt(boundary(make_triangle(make_point(0,0), make_point(5,5), make_point(0,10)))) → ‘LineString (0 0, 5 5, 0 10, 0 0)’

13.2.13.80. make_valid

ဤ function သည် ဆီလျော်မှုရှိသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ သို့မဟုတ် ဂျီဩမေတြီကို ဆီလျော်မှုရှိအောင် ပြုလုပ်နိုင်ခြင်း မရှိပါက ဗလာဖြစ်နေသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	make_valid(geometry, [method=structure], [keep_collapsed=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု method - ပြန်လည်ပြုပြင်ပေးသည့် algorithm ဖြစ်သည်။ ၎င်းသည် ‘structure’(ဖွဲ့စည်းပုံဆိုင်ရာ) အရ သို့မဟုတ် ‘linework’ (မျဉ်းကြောင်းဆိုင်ရာ) အရ ဖြစ်နိုင်ပါသည်။ ‘linework’ နည်းလမ်းသည် နယ်နိမိတ်ကွင်းများအားလုံးကို အဆစ်များပါသော မျဉ်းကြောင်းများအဖြစ် ပေါင်းစည်းပြီးနောက် အဆိုပါ မျဉ်းကြောင်းပုံမှ ဆီလျော်မှုရှိသော polygon များကို ထုတ်ယူပေးပါသည်။ ‘structure’ နည်းလမ်းမှာမူ နယ်နိမိတ်ကွင်းများအားလုံးကို ဆီလျော်မှုရှိအောင် ဦးစွာ ပြုလုပ်ပြီးနောက် ပြင်ပကွင်း (shell) များကို ပေါင်းစပ်ကာ အပေါက်များ (holes) ကို နှုတ်ယူပြီး ဆီလျော်မှုရှိသော ရလဒ်ကို ထုတ်ပေးခြင်းဖြစ်သည်။ Shell များနှင့် hole များကို မှန်မှန်ကန်ကန် အမျိုးအစားခွဲထားသည်ဟု ယူဆပါသည်။ keep_collapsed - True ဟုသတ်မှတ်ထားပါက တစ်ဆင့်နိမ့်သော အတိုင်းအတာဂုဏ်သတ္တိ (dimensionality) တစ်ခုအဖြစ်သို့ ကျဆင်းသွားသော အစိတ်အပိုင်းများကို ဆက်လက်ထားရှိပေးမည်ဖြစ်သည်။ ဥပမာအားဖြင့် နယ်နိမိတ်ကွင်းတစ်ခုသည် မျဉ်းကြောင်းတစ်ကြောင်းအဖြစ် ကျဆင်းသွားပြီး မျဉ်းကြောင်းတစ်ကြောင်းသည် point တစ်ခုအဖြစ်သို့ ကျဆင်းသွားခြင်းဖြစ်သည်။
ဥပမာများ	geom_to_wkt(make_valid(geom_from_wkt('POLYGON((3 2, 4 1, 5 8, 3 2, 4 2))'))) → ‘Polygon ((3 2, 5 8, 4 1, 3 2))’ geom_to_wkt(make_valid(geom_from_wkt('POLYGON((3 2, 4 1, 5 8, 3 2, 4 2))'), 'linework')) → ‘GeometryCollection (Polygon ((5 8, 4 1, 3 2, 5 8)),LineString (3 2, 4 2))’ geom_to_wkt(make_valid(geom_from_wkt('POLYGON((3 2, 4 1, 5 8))'), method:='linework')) → ‘Polygon ((3 2, 4 1, 5 8, 3 2))’ make_valid(geom_from_wkt('LINESTRING(0 0)')) → ဗလာဖြစ်နေသော ဂျီဩမေတြီ

ထပ်မံဖတ်ရှုရန်- is_valid ၊ ဂျီဩမေတြီများကိုပြင်ခြင်း (Fix geometries) algorithm

13.2.13.81. minimal_circle

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ minimal enclosing circle (အငယ်ဆုံး ဝိုင်းကာထားသော စက်ဝိုင်း) ကို ရရှိစေပါသည်။ ၎င်းသည် အစုထဲရှိ ဂျီဩမေတြီများအားလုံးကို ဝိုင်းကာထားသော အငယ်ဆုံးစက်ဝိုင်းကို ကိုယ်စားပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	minimal_circle(geometry, [segments=36]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု segments - Polygon မျဉ်းပိုင်းများ ပိုင်းခြင်း (segmentation) အတွက် optional ဖြစ်သော argument ဖြစ်သည်။ Default အားဖြင့် ထိုတန်ဖိုးမှာ 36 ဖြစ်သည်။
ဥပမာများ	geom_to_wkt( minimal_circle( geom_from_wkt( 'LINESTRING(0 5, 0 -5, 2 1)' ), 4 ) ) → ‘Polygon ((0 5, 5 -0, -0 -5, -5 0, 0 5))’ geom_to_wkt( minimal_circle( geom_from_wkt( 'MULTIPOINT(1 2, 3 4, 3 2)' ), 4 ) ) → ‘Polygon ((3 4, 3 2, 1 2, 1 4, 3 4))’

ထပ်မံဖတ်ရှုရန်- အသေးဆုံး ဘောင်ခတ်စက်ဝိုင်းများ (Minimum enclosing circles) algorithm

13.2.13.82. nodes_to_points

ဤ function သည် ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီထဲရှိ မျဉ်းဆစ်တိုင်းပါဝင်သော multipoint (point များစွာပါသော) ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	nodes_to_points(geometry, [ignore_closing_nodes=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီ ignore_closing_nodes - polygon ကွင်းများ သို့မဟုတ် မျဉ်းများကို ပိတ်ပေးသော ထပ်နေသည့် မျဉ်းဆစ်များ ပါဝင်သင့်/မသင့်ကို သတ်မှတ်သည့် optional ဖြစ်သော argument ဖြစ်ပါသည်။ Default အားဖြင့် false ဖြစ်နေမည်ဖြစ်ပြီး၊ ရလာဒ်တွင် ထိုထပ်နေသောမျဉ််းဆစ်များ မပါဝင်စေရန် true ကိုရွေးချယ်ရမည်ဖြစ်သည်။
ဥပမာများ	geom_to_wkt(nodes_to_points(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘MultiPoint ((0 0),(1 1),(2 2))’ geom_to_wkt(nodes_to_points(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1))'),true)) → ‘MultiPoint ((-1 -1),(4 0),(4 2),(0 2))’

ထပ်မံဖတ်ရှုရန်- Vertex များကို ထုတ်ယူခြင်း (Extract vertices) algorithm

13.2.13.83. num_geometries

ဤ function သည် ဂျီဩမေတြီစုစည်းမှု (collection) တစ်ခုထဲရှိ ဂျီဩမေတြီအရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် အစိတ်အပိုင်းများစွာပါဝင်သော ဂျီဩမေတြီထဲရှိ အစိတ်အပိုင်းအရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီသည် စုစည်းမှု (collection) တစ်ခုမဟုတ်ပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	num_geometries(geometry)
Argument များ	geometry - ဂျီဩမေတြီ စုစည်းမှု သို့မဟုတ် အစိတ်အပိုင်းများစွာပါဝင်သော ဂျီဩမေတြီ
ဥပမာများ	num_geometries(geom_from_wkt('GEOMETRYCOLLECTION(POINT(0 1), POINT(0 0), POINT(1 0), POINT(1 1))')) → 4 num_geometries(geom_from_wkt('MULTIPOINT((0 1), (0 0), (1 0))')) → 3

13.2.13.84. num_interior_rings

ဤ function သည် polygon တစ်ခု သို့မဟုတ် ဂျီဩမေတြီစုစည်းမှု တစ်ခုအတွင်းရှိ အတွင်းကွင်းအရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီသည် စုစည်းမှုတစ်ခု သို့မဟုတ် polygon တစ်ခု မဟုတ်ပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	num_interior_rings(geometry)
Argument များ	geometry - ထည့်သွင်းသည့် ဂျီဩမေတြီ
ဥပမာများ	num_interior_rings(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))')) → 1

13.2.13.85. num_points

ဤ function သည် ဂျီဩမေတြီတစ်ခုအတွင်းရှိ မျဉ်းဆစ် (vertex) အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	num_points(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	num_points(@geometry) → လက်ရှိ feature ၏ ဂျီဩမေတြီထဲရှိ မျဉ်းအဆစ် (vertex) အရေအတွက်

13.2.13.86. num_rings

ဤ function သည် polygon တစ်ခု သို့မဟုတ် ဂျီဩမေတြီစုစည်းမှုတစ်ခုအတွင်းရှိ (အပြင်ကွင်းအပါအဝင်) ကွင်းအရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီသည် စုစည်းမှုတစ်ခု သို့မဟုတ် polygon တစ်ခု မဟုတ်ပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	num_rings(geometry)
Argument များ	geometry - ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီ
ဥပမာများ	num_rings(geom_from_wkt('POLYGON((-1 -1, 4 0, 4 2, 0 2, -1 -1),(-0.1 -0.1, 0.4 0, 0.4 0.2, 0 0.2, -0.1 -0.1))')) → 2

13.2.13.87. offset_curve

ဤ function သည် linestring ဂျီဩမေတြီတစ်ခုကို ဘေးသို့ ရွှေ့ခြင်းဖြင့်ဖြစ်ပေါ်လာသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကွာအဝေးများသည် ထိုဂျီဩမေတြီ၏ ရည်ညွှန်းကိုဩဒိနိတ်စနစ် (SRS) အတိုင်း ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	offset_curve(geometry, distance, [segments=8], [join=1], [miter_limit=2.0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - linestring (multi) ဂျီဩမေတြီတစ်ခု distance - offset (အရွေ့) အကွာအဝေးဖြစ်သည်။ အပေါင်းတန်ဖိုးများသည် မျဉ်းများ၏ ဘယ်ဘက်သို့ buffer ပြုလုပ်မည်ဖြစ်ပြီး အနှုတ်တန်ဖိုးများသည် ညာဘက်သို့ buffer ပြုလုပ်မည်ဖြစ်သည်။ segments - လုံးဝန်းသော (round) ချိတ်ဆက်မှု (join) style ကို အသုံးပြုသောအခါ စက်ဝိုင်း၏လေးပုံတစ်ပုံကို ဖော်ပြရာတွင် အသုံးပြုသည့် မျဉ်းပိုင်းအရေအတွက်ဖြစ်ပါသည်။ အရေအတွက် ပိုများပါက အဆစ်များပိုမိုပါဝင်သည့် ချောမွေ့သော မျဉ်းကို ရရှိစေပါသည်။ join - ထောင့်များအတွက် ချိတ်ဆက်မှုပုံစံ (join style) ။ အသုံးပြုနိုင်သော ပုံစံများမှာ 1 = round ၊ 2 = miter နှင့် 3 = bevel တို့ဖြစ်သည်။ miter_limit - အလွန်ချွန်သော ထောင့်များအတွက် အသုံးပြုသော miter အချိုး ကန့်သတ်ချက် (miter ချိတ်ဆက်မှုကို အသုံးပြုသောအခါမှသာ)
ဥပမာများ	offset_curve(@geometry, 10.5) → 10.5 ယူနစ်ဖြင့် ဘယ်ဘက်သို့ မျဉ်းအရွေ့ offset_curve(@geometry, -10.5) → 10.5 ယူနစ်ဖြင့် ညာဘက်သို့ မျဉ်းအရွေ့ offset_curve(@geometry, 10.5, segments:=16, join:=1) → 10.5 ယူနစ်ဖြင့် ဘယ်ဘက်သို့ မျဉ်းအရွေ့၊ ပိုမိုချောမွေ့သော မျဉ်းကွေးရရှိရန် မျဉ်းပိုင်းများ ပိုမိုအသုံးပြုထားလျှက် offset_curve(@geometry, 10.5, join:=3) → 10.5 ယူနစ်ဖြင့် ဘယ်ဘက်သို့ မျဉ်းအရွေ့၊ bevel ချိတ်ဆက်မှုကို အသုံးပြုလျှက်

ထပ်မံဖတ်ရှုရန်- အပြိုင် မျဉ်းများ (Offset lines) algorithm

13.2.13.88. order_parts

ဂျီဩမေတြီများစွာပါဝင်သည့် ဂျီဩမေတြီတစ်ခု၏ အစိတ်အပိုင်းများကို သတ်မှတ်ထားသည့် စံနှုန်းတစ်ခုဖြင့် စီစဉ်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	order_parts(geometry, orderby, [ascending=true]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - အမျိုးအစားများစွာပါဝင်သည့် ဂျီဩမေတြီတစ်ခု orderby - အစီအစဉ်ပြုလုပ်မည့် စံနှုန်းကို သတ်မှတ်သည့် expression တစ်ခု ascending - မှား/မှန် ဖော်ပြချက်၊ ငယ်စဉ်ကြီးလိုက်စီစဉ်မှုအတွက် True ဖြစ်ပြီး၊ ကြီးစဉ်ငယ်လိုက်စီစဉ်မှုအတွက် False ဖြစ်သည်။
ဥပမာများ	geom_to_wkt(order_parts(geom_from_wkt('MultiPolygon (((1 1, 5 1, 5 5, 1 5, 1 1)),((1 1, 9 1, 9 9, 1 9, 1 1)))'), 'area(@geometry)', False)) → ‘MultiPolygon (((1 1, 9 1, 9 9, 1 9, 1 1)),((1 1, 5 1, 5 5, 1 5, 1 1)))’ geom_to_wkt(order_parts(geom_from_wkt('LineString(1 2, 3 2, 4 3)'), '1', True)) → ‘LineString(1 2, 3 2, 4 3)’

13.2.13.89. oriented_bbox

ဤ function သည် ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီ၏ အနိမ့်ဆုံး ဦးတည်ရာ စတုဂံပုံအကျယ်အဝန်းနယ် (minimal oriented bounding box) ကို ကိုယ်စားပြုသည့် ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	oriented_bbox(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( oriented_bbox( geom_from_wkt( 'MULTIPOINT(1 2, 3 4, 3 2)' ) ) ) → ‘Polygon ((3 2, 3 4, 1 4, 1 2, 3 2))’

ထပ်မံဖတ်ရှုရန်- အလိုက်သင့်လှည့်အသေးဆုံးဘောင် box (Oriented minimum bounding box) algorithm

13.2.13.90. overlaps

ဤ function သည် ဂျီဩမေတြီများ တစ်ခုနှင့်တစ်ခု ထပ်နေခြင်းရှိ/မရှိကို စစ်ဆေးခြင်းဖြစ်သည်။ အကယ်၍ ဂျီဩမေတြီများသည် တူညီသည့်အတိုင်းအတာဖြင့် ထပ်နေပြီး ဂျီဩမေတြီတစ်ခုအတွင်း အခြားတစ်ခုမှ အပြည့်အဝ ပါဝင်နေခြင်းမဖြစ်လျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlaps(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	overlaps( geom_from_wkt( 'LINESTRING(3 5, 4 4, 5 5, 5 3)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE overlaps( geom_from_wkt( 'LINESTRING(0 0, 1 1)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → FALSE

13.2.13.91. overlay_contains

ဤ function သည် လက်ရှိအသုံးပြုနေသော feature တွင် ရည်ရွယ်သည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုသည် တည်နေရာအားဖြင့် ပါဝင်ခြင်းရှိ/မရှိ ကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature တွင်ပါဝင်သော ရည်ရွယ်သည့် layer ရှိ feature များအတွက် expression ကို အခြေခံထားသောရလာဒ်များ array တစ်ခုကိုပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Contains function တွင် ဖော်ပြထားသည့်အတိုင်း GEOS “Contains” ခေါင်းစဉ်အောက်တွင် ဆက်လက်ဖတ်ရှုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_contains(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_contains('regions') → လက်ရှိ feature တွင် တည်နေရာအရ နေရာဒေသ (region) တစ်ခုပါဝင်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_contains('regions', filter:= population > 10000) → လက်ရှိ feature တွင် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုပါဝင်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_contains('regions', name) → လက်ရှိ feature တွင် ပါဝင်သော region များအတွက် နာမည်စဉ် (array of names) များ array_to_string(overlay_contains('regions', name)) → လက်ရှိ feature တွင် ပါဝင်သော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်းစာသားတစ်ခု array_sort(overlay_contains(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature တွင် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက် စီထားသော အမည်များ array တစ်ခု overlay_contains(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature တွင် ပါဝင်သော region နှစ်ခုထိအတွက် ဂျီဩမေတြီများ array တစ်ခု (WKT ဖြင့်)

ထပ်မံဖတ်ရှုရန်- contains ၊ array manipulation ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) algorithm

13.2.13.92. overlay_crosses

ဤ function သည် လက်ရှိအသုံးပြုနေသော feature အနေဖြင့် ရည်ရွယ်ထားသည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုကို ကန့်လန့်ဖြတ်သွားခြင်းရှိ/မရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature မှ ကန့်လန့်ဖြတ်သွားသော ရည်ရွယ်သည့် layer ရှိ feature များအတွက် expression ကို အခြေခံထားသော ရလာဒ်များ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Crosses function တွင် ဖော်ပြထားသော GEOS “Crosses” ခေါင်းစဉ်အောက်တွင် ဆက်လက်ဖတ်ရှုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_crosses(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_crosses('regions') → လက်ရှိ feature တွင် တည်နေရာအရ နေရာဒေသ (region) တစ်ခုကို ကန့်လန့်ဖြတ်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_crosses('regions', filter:= population > 10000) → လက်ရှိ feature တွင် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုကို ကန့်လန့်ဖြတ်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_crosses('regions', name) → လက်ရှိ feature မှ ကန့်လန့်ဖြတ်သော region များအတွက် နာမည်စဉ် (array of names) များ array_to_string(overlay_crosses('regions', name)) → လက်ရှိ feature မှ ကန့်လန့်ဖြတ်သွားသော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်းစာသားတစ်ခု array_sort(overlay_crosses(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature မှ ကန့်လန့်ဖြတ်သွားပြီး လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက် စီထားသော အမည်များ array တစ်ခု overlay_crosses(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature မှ ကန့်လန့်ဖြတ်သွားသော region နှစ်ခုထိအတွက် ဂျီဩမေတြီများ array တစ်ခု (WKT ဖြင့်)

ထပ်မံဖတ်ရှုရန်- crosses ၊ array manipulation (Array များကို ကိုင်တွယ်ခြင်း) ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) (တည်နေရာဖြင့် feature/attribute များကို ရွေးချယ်ခြင်း) algorithm

13.2.13.93. overlay_disjoint

ဤ function တွင် လက်ရှိ feature သည် ရည်ရွယ်ထားသည့် layer တစ်ခု၏ feature များအားလုံးနှင့် တည်နေရာအရ ဆက်စပ်မှုရှိမရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature မှ ဆက်စပ်မှုမရှိသော ရည်ရွယ်ထားသည့် layer ထဲရှိ feature များအတွက် expression ကို အခြေခံထားသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Disjoint function တွင် ဖော်ပြထားသည့် GEOS “Disjoint” ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_disjoint(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_disjoint('regions') → လက်ရှိ feature သည် တည်နေရာအရ နေရာဒေသ (region) အားလုံးနှင့် ဆက်စပ်မှုမရှိပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_disjoint('regions', filter:= population > 10000) → လက်ရှိ feature သည် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များအားလုံးနှင့် ဆက်စပ်မှုမရှိပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_disjoint('regions', name) → လက်ရှိ feature မှ တည်နေရာအရ ဆက်စပ်မှုမရှိသော region များအတွက် နာမည်စဉ် (array of names) များ array_to_string(overlay_disjoint('regions', name)) → လက်ရှိ feature မှ တည်နေရာအရ ဆက်စပ်မှုမရှိသော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်းစာသားတစ်ခု array_sort(overlay_disjoint(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature မှ တည်နေရာအရ ဆက်စပ်မှုမရှိပဲ လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက် စီထားသော အမည်များ array တစ်ခု overlay_disjoint(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature မှ တည်နေရာအရ ဆက်စပ်မှုမရှိသည့် region နှစ်ခုထိအတွက် ဂျီဩမေတြီများ array တစ်ခု (WKT ဖြင့်)

ထပ်မံဖတ်ရှုရန်- disjoint ၊ array manipulation ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) algorithm

13.2.13.94. overlay_equals

ဤ function တွင် လက်ရှိ feature သည် ရည်ရွယ်သည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုခုနှင့် တည်နေရာအရ တူညီမှုရှိမရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature နှင့် တည်နေရာအရတူညီမှုရှိသည့် ရည်ရွယ်သည့် layer ထဲရှိ feature များအတွက် expression ကိုအခြေခံသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Equals function တွင် ဖော်ပြထားသည့် GEOS “Equals” ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_equals(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_equals('regions') → လက်ရှိ feature သည် တည်နေရာအရ နေရာဒေသ (region) တစ်ခုနှင့် တူညီမှုရှိပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_equals('regions', filter:= population > 10000) → လက်ရှိ feature သည် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုနှင့် တည်နေရာအရ တူညီမှုရှိပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_equals('regions', name) → လက်ရှိ feature နှင့် တည်နေရာအရ တူညီမှုရှိသော region များအတွက် နာမည်စဉ် (array of names) များ array_to_string(overlay_equals('regions', name)) → လက်ရှိ feature နှင့် တည်နေရာအရ တူညီမှုရှိသော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်းစာသားတစ်ခု array_sort(overlay_equals(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature နှင့် တည်နေရာအရ တူညီမှုရှိပြီး လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက် စီထားသော အမည်များ array တစ်ခု overlay_equals(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature နှင့် တည်နေရာအရ တူညီမှုရှိသော region နှစ်ခုထိအတွက် ဂျီဩမေတြီများ array တစ်ခု (WKT ဖြင့်)

ထပ်မံဖတ်ရှုရန်- array manipulation (Array များကို ကိုင်တွယ်ခြင်း)၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) (တည်နေရာဖြင့် feature/attribute များကို ရွေးချယ်ခြင်း) algorithm

13.2.13.95. overlay_intersects

ဤ function တွင် လက်ရှိ feature သည် ရည်ရွယ်သည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုခုနှင့် တည်နေရာအရ ထိဖြတ်ခြင်းရှိမရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature မှ ထိဖြတ်သွားသော ရည်ရွယ်သည့် layer ထဲရှိ feature များအတွက် expression ကိုအခြေခံသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Intersects function တွင် ဖော်ပြထားသည့် GEOS “Intersects” ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_intersects(layer, [expression], [filter], [limit], [cache=false], [min_overlap], [min_inscribed_circle_radius], [return_details], [sort_by_intersection_size]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ) min_overlap - Optional ဖြစ်သော ဖယ်ထုတ်ပေးသည့် စစ်ထုတ်မှု (filter) တစ်ခုကို သတ်မှတ်ပေးပါသည်။ Polygon များအတွက် ထိဖြတ်ခြင်းသည် စတုရန်းယူနစ်ဖြင့် ဖော်ပြသော လက်ရှိ feature ထဲရှိ အနည်းဆုံးဧရိယာတစ်ခုဖြစ်သည်။ အကယ်၍ ထိဖြတ်ခြင်းသည် polygon များစွာထဲတွင်ဖြစ်နေပါက ထို polygon များထဲမှ အနည်းဆုံး polygon တစ်ခုသည် သတ်မှတ်ထားသည့်တန်ဖိုးထက် ကြီးသော သို့မဟုတ် တူညီသော ဧရိယာရှိလျှင် ထိဖြတ်ခြင်းကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ Line များအတွက် လက်ရှိ feature ၏ ယူနစ်ဖြင့် တိုင်းတာသည့် အနည်းဆုံးအလျားတစ်ခုဖြစ်သည်။ အကယ်၍ ထိဖြတ်ခြင်းတွင် line များစွာပါဝင်နေပါက ထို line များထဲမှ အနည်းဆုံး line တစ်ခုသည် သတ်မှတ်ထားသည့် တန်ဖိုးထက် ကြီးသော သို့မဟုတ် တူညီသော အလျားရှိလျှင် ထိဖြတ်ခြင်းကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ min_inscribed_circle_radius သည် optional ဖြစ်သော ဖယ်ထုတ်ပေးသည့် စစ်ထုတ်မှု (filter) တစ်ခုကို သတ်မှတ်ပေးပါသည် (polygon များအတွက်သာ)။ ၎င်းသည် ထိဖြတ်ခြင်း၏ အများဆုံး အတွင်းပိုင်းဝန်းထိသော စက်ဝိုင်း (maximum inscribed circle) အတွက် လက်ရှိ feature ၏ ယူနစ်ဖြင့်တိုင်းတာသော အနည်းဆုံးအချင်းဝက်ဖြစ်သည်။ အကယ်၍ ထိဖြတ်ခြင်းသည် polygon များစွာအတွင်း၌ ဖြစ်ပေါ်ခဲ့သော် ထို polygon များထဲမှ အနည်းဆုံး polygon တစ်ခုတွင် maximum inscribed circle အတွက် အချင်းဝက်သည် သတ်မှတ်ထားသည့်တန်ဖိုးထက် ပိုကြီးသော သို့မဟုတ် တူညီသော တန်ဖိုးရှိပါက ထိဖြတ်ခြင်းကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ PostGIS ရှိ ST_MaximumInscribedCircle function တွင် ဖော်ပြထားသည့် GEOS ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။ ဤ argument သည် GEOS >= 3.9 နှင့်အထက်ဖြစ်ရန် လိုအပ်ပါသည်။ return_details - feature ‘id’ ၊ expression ‘result (ရလဒ်)’ နှင့် ‘overlap (ထပ်ခြင်း)’ တန်ဖိုးများပါဝင်သော ဖော်ပြချက်များစာရင်း (key အမည်များကို ‘ ‘ ထဲတွင်ထည့်ထားသည်) ကိုရရှိရန် ၎င်းကို true ဟု သတ်မှတ်ပါ။ ရည်ရွယ်သည့် layer သည် polygon ဖြစ်ပါက maximum inscribed circle ၏ အချင်းဝက်ကိုလည်း ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ Expression parameter ဖြင့် အသုံးပြုမှသာ ဆီလျော်မှုရှိမည်ဖြစ်သည်။ sort_by_intersection_size - Expression ဖြင့် အသုံးပြုမှသာ ဆီလျော်မှုရှိမည်ဖြစ်သည်။ ထပ်နေသည့်တန်ဖိုးဖြင့် ရလာဒ်ကို ကြီးစဉ်ငယ်လိုက်အစဉ်ဖြင့် ပြန်ထုတ်ရန် ‘des’ ဟု သတ်မှတ်ပါ၊ သို့မဟုတ် ငယ်စဉ်ကြီးလိုက်အစဉ်ဖြင့်စီလိုသော် ‘asc’ ဟု သတ်မှတ်ပါ။
ဥပမာများ	overlay_intersects('regions') → လက်ရှိ feature သည် တည်နေရာအရ နေရာဒေသ (region) တစ်ခုနှင့် ထိဖြတ်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_intersects('regions', filter:= population > 10000) → လက်ရှိ feature သည် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုနှင့် တည်နေရာအရ ထိဖြတ်ပါက TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_intersects('regions', name) → လက်ရှိ feature မှ တည်နေရာအရ ထိဖြတ်သော region များအတွက် နာမည်စဉ် (array of names) များ array_to_string(overlay_intersects('regions', name)) → လက်ရှိ feature မှ တည်နေရာအရ ထိဖြတ်သော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်းစာသားတစ်ခု array_sort(overlay_intersects(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature မှ တည်နေရာအရ ထိဖြတ် လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များအတွက် အစဉ်လိုက် စီထားသော အမည်များ array တစ်ခု overlay_intersects(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature မှ တည်နေရာအရ ထိဖြတ်သော region နှစ်ခုထိအတွက် ဂျီဩမေတြီများ array တစ်ခု (WKT ဖြင့်) overlay_intersects(layer:='regions', min_overlap:=0.54) → လက်ရှိ feature သည် region တစ်ခုကို တည်နေရာအရ ထိဖြတ်ပြီး ထို ထိဖြတ်ဧရိယာ (polygon များစွာပါဝင်နေပါက အစိတ်အပိုင်းများထဲမှ အနည်းဆုံးတစ်ပိုင်း)သည် 0.54 နှင့် ညီမျှလျှင် သို့မဟုတ် ပိုကြီးလျှင် TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_intersects(layer:='regions', min_inscribed_circle_radius:=0.54) → လက်ရှိ feature သည် region တစ်ခုကို တည်နေရာအရ ထိဖြတ်ပြီး ထို ထိဖြတ်ဧရိယာ maximum inscribed circle ၏ အချင်းဝက် (အပိုင်းများစွာပါဝင်ပါက အနည်းဆုံးတစ်ခု) 0.54 နှင့်ညီမျှလျှင် သို့မဟုတ် ပိုကြီးလျှင် TRUE ကိုပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_intersects(layer:='regions', expression:= geom_to_wkt(@geometry), return_details:=true) → ‘id’ ၊ ‘result’ ၊ ‘overlap’ နှင့် ‘radius’ တို့ ပါဝင်သော ဖော်ပြချက် array တစ်ခု overlay_intersects(layer:='regions', expression:= geom_to_wkt(@geometry), sort_by_intersection_size:='des') → ထပ်နေသော တန်ဖိုးဖြင့် ကြီးစဉ်ငယ်လိုက်စဉ်ထားသော (WKT ဖြင့်) ဂျီဩမေတြီ array တစ်ခု

ထပ်မံဖတ်ရှုရန်- intersects ၊ array manipulation (Array များကို ကိုင်တွယ်ခြင်း) ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) (တည်နေရာဖြင့် feature/attribute များကို ရွေးချယ်ခြင်း) algorithm

13.2.13.96. overlay_nearest

ဤ function တွင် လက်ရှိ feature သည် သတ်မှတ်ထားသည့် အကွာအဝေးတစ်ခုအတွင်းတွင် ရည်ရွယ်သည့် layer တစ်ခုမှ feature (များ) ပါဝင်ခြင်းရှိ/မရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature မှ အကွာအဝေးတစ်ခုအတွင်း ရည်ရွယ်သည့် layer ထဲရှိ feature များအတွက် expression ကိုအခြေခံသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

မှတ်ချက်။ ဤ function သည် ကြီးမားသော layer များအတွက် မှတ်ဉာဏ်အမြောက်အမြားသုံးစွဲရသဖြင့် လုပ်ဆောင်မှုနှေးကွေးနိုင်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_nearest(layer, [expression], [filter], [limit=1], [max_distance], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ရည်ရွယ်သည့် layer ထဲရှိ feature များအားလုံးကို အသုံးပြုသွားမည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက အနီးဆုံးဖြစ်သော feature ကိုသာ ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ -1 ကို သတ်မှတ်ထားပါက ကိုက်ညီမှုရှိသော feature များအားလုံးကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ max_distance - ကိုက်ညီမှုရှိသော feature များကို ရှာဖွေရန်အတွက် optional ဖြစ်သော ကန့်သတ်ချက်အကွာအဝေး တစ်ခုဖြစ်သည်။ သတ်မှတ်မထားပါက ရည်ရွယ်သည့် layer ထဲရှိ feature များအားလုံးကို အသုံးပြုသွားမည်ဖြစသည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_nearest('airports') → “airports” layer တွင် အနည်းဆုံး feature တစ်ခုရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_nearest('airports', max_distance:= 5000) → လက်ရှိ feature မှ မြေပုံယူနစ် 5000 အကွာအဝေးအတွင်း လေဆိပ်တစ်ခုရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_nearest('airports', name) → လက်ရှိ feature နှင့်အနီးဆုံးရှိသော လေဆိပ်အတွက် array တစ်ခုအနေဖြင့် လေဆိပ်အမည် array_to_string(overlay_nearest('airports', name)) → လက်ရှိ feature နှင့်အနီးဆုံးရှိသော လေဆိပ်အတွက် စာသား တစ်ခုအနေဖြင့် လေဆိပ်အမည် overlay_nearest(layer:='airports', expression:= name, max_distance:= 5000) → လက်ရှိ feature မှ မြေပုံယူနစ် 5000 အကွာအဝေးအတွင်း အနီးဆုံးရှိသောလေဆိပ်အတွက် array တစ်ခုအနေဖြင့် လေဆိပ်အမည် overlay_nearest(layer:='airports', expression:="name", filter:= "Use"='Civilian', limit:=3) → အကွာအဝေးဖြင့် စဉ်ထားသော အနီးဆုံးပြည်သူပိုင်လေဆိပ် ၃ ခုအထိပါဝင်သော အမည်များ array တစ်ခု overlay_nearest(layer:='airports', expression:="name", limit:= -1, max_distance:= 5000) → လက်ရှိ feature မှ မြေပုံယူနစ် 5000 အတွင်း အကွာအဝေးဖြင့် စဉ်ထားသော လေဆိပ်များအားလုံးအတွက် အမည်များ array တစ်ခု

ထပ်မံဖတ်ရှုရန်- array manipulation (Array များကို ကိုင်တွယ်ခြင်း) ၊ နီးစပ်မှုဖြင့် attribute များကိုချိတ်ဆက်ခြင်း (Join attributes by nearest) algorithm

13.2.13.97. overlay_touches

ဤ function တွင် လက်ရှိ feature သည် ရည်ရွယ်သည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုနှင့် တည်နေရာအရ ထိစပ်ခြင်း ရှိမရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature မှ ထိစပ်နေသော ရည်ရွယ်သည့် layer ထဲရှိ feature များအတွက် expression ကိုအခြေခံသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Touches function တွင် ဖော်ပြထားသည့် GEOS “Touches” ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_touches(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ကိုက်ညီမှုရှိသော feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_touches('regions') → လက်ရှိ feature သည် region တစ်ခုနှင့် တည်နေရာအရ ထိစပ်မှုရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_touches('regions', filter:= population > 10000) → လက်ရှိ feature သည် လူဦးရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုနှင့် ထိစပ်မှုရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_touches('regions', name) → လက်ရှိ feature မှ ထိစပ်နေသော region များအတွက် နာမည်များ array တစ်ခု string_to_array(overlay_touches('regions', name)) → လက်ရှိ feature မှ ထိစပ်နေသော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်စာရင်း စာသားတစ်ခု array_sort(overlay_touches(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature နှင့် ထိစပ်မှုရှိပြီး လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက် စီထားသော နာမည်များ array တစ်ခု overlay_touches(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature နှင့်ထိစပ်နေသော ဂျီဩမေတြီနှစ်ခုထိ (WKT ဖြင့်) ပါဝင်သည့် ဂျီဩမေတြီများ array တစ်ခု

ထပ်မံဖတ်ရှုရန်- touches ၊ array manipulation ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) algorithm

13.2.13.98. overlay_within

ဤ function တွင် လက်ရှိ feature သည် ရည်ရွယ်သည့် layer တစ်ခုမှ အနည်းဆုံး feature တစ်ခုအတွင်းတွင် တည်နေရာအရ ကျရောက်ခြင်းရှိ/မရှိကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် လက်ရှိ feature ပါဝင်နေသော ရည်ရွယ်သည့် layer ထဲရှိ feature များအတွက် expression ကိုအခြေခံသော ရလာဒ်များ၏ array တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

PostGIS ရှိ ST_Within function တွင် ဖော်ပြထားသည့် GEOS “Within” ခေါင်းစဉ်အောက်တွင် ပိုမိုလေ့လာနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	overlay_within(layer, [expression], [filter], [limit], [cache=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	layer - ထပ်ခြင်းကို စစ်ဆေးမည့် layer expression - ရည်ရွယ်ထားသည့် layer မှ feature များကို အကဲဖြတ်စစ်ဆေးမည့် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ဤ function သည် အနည်းဆုံးကိုက်ညီမှုတစ်ခု ရှိ/မရှိကို ညွှန်ပြသော မှန်/မှား တစ်ခုကိုသာ ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ filter - စစ်ဆေးမည့် ရည်ရွယ်ထားသော feature များကို စစ်ထုတ် (filter) ရန် optional ဖြစ်သော expression တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက feature များအားလုံးကို စစ်ဆေးသွားလိမ့်မည်ဖြစ်သည်။ limit - ကိုက်ညီမှုရှိသည့် feature အရေအတွက်ကို ကန့်သတ်မည့် optional ဖြစ်သော ကိန်းပြည့်တစ်ခုဖြစ်သည်။ အကယ်၍ သတ်မှတ်မထားပါက ကိုက်ညီမှုရှိသော feature များအားလုံးကို ပြန်ထုတ်ပေးလိမ့်မည်ဖြစ်သည်။ cache - local spatial index (စက်အတွင်း သီးသန့်သိမ်းဆည်းသည့် တည်နေရာဆိုင်ရာအညွှန်းကိန်း) တစ်ခုကို တည်ဆောက်နိုင်ရန် ၎င်းကို ture ဟု သတ်မှတ်ထားရမည် (များသောအားဖြင့် နှေးကွေးသော ဒေတာဝန်ဆောင်မှုများနှင့် အလုပ်လုပ်မနေပါက ၎င်းကို လိုချင်မည်မဟုတ်ပေ)
ဥပမာများ	overlay_within('regions') → လက်ရှိ feature သည် တည်နေရာအရ region တစ်ခုအတွင်း တည်ရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_within('regions', filter:= population > 10000) → လက်ရှိ feature သည် လူဦးရေ 10000 ထက်ကျော်လွန်သော region တစ်ခုအတွင်း တည်နေရာအရ တည်ရှိပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည် overlay_within('regions', name) → လက်ရှိ feature ကျရောက်နေသော region များအတွက် အမည်များ array တစ်ခု array_to_string(overlay_within('regions', name)) → လက်ရှိ feature ကျရောက်နေသော region များအတွက် ကော်မာဖြင့် ခွဲခြားရေးသားထားသည့် အမည်များစာရင်းစာသားတစ်ခု array_sort(overlay_within(layer:='regions', expression:="name", filter:= population > 10000)) → လက်ရှိ feature ကျရောက်နေပြီး လူဦး‌ရေ 10000 ထက်ကျော်လွန်သော region များ၏ အစဉ်လိုက်စီထားသော အမည်များ array တစ်ခု overlay_within(layer:='regions', expression:= geom_to_wkt(@geometry), limit:=2) → လက်ရှိ feature ကျရောက်နေသော region နှစ်ခုထိ ပါဝင်သည့် (WKT ဖြင့်) ဂျီဩမေတြီများ array တစ်ခု

ထပ်မံဖတ်ရှုရန်- within ၊ array manipulation ၊ တည်နေရာဖြင့် ရွေးချယ်ခြင်း (Select by location) algorithm

13.2.13.99. $perimeter

ဤ function သည် လက်ရှိ feature ၏ ပတ်လည်အနား အလျားကို ပြန်ထုတ်ပေးပါသည်။ ဤ function မှ တွက်ထုတ်ထားသော ပတ်လည်အနားသည် လက်ရှိ project ၏ စက်လုံးပုံ (ellipsoid) setting နှင့် အကွာအဝေးယူနစ် setting နှစ်မျိုးစလုံးအတိုင်း ဖြစ်ပါသည်။ ဥပမာအားဖြင့် project ကို စက်လုံးပုံ (ellipsoid) အဖြစ် သတ်မှတ်ထားပါက တွက်ချက်မှုမှရရှိလာသော ပတ်လည်အနားသည် စက်လုံးပုံအတိုင်း ဖြစ်နေမည်ဖြစ်ပြီး စက်လုံးပုံ setting သတ်မှတ်မထားပါက တွက်ချက်ရရှိသော ပတ်လည်အနားသည် ပြင်ညီဆိုင်ရာ (planimetric) ပတ်လည်အနားဖြစ်နေပေလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$perimeter
ဥပမာများ	$perimeter → 42

13.2.13.100. perimeter

ဤ function သည် polygon ဂျီဩမေတြီတစ်ခု၏ ပတ်လည်အနားကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများကို ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) ရှိ ပြင်ညီအတိုင်း တွက်ချက်ပြီး ရရှိလာသော ပတ်လည်အနား၏ ယူနစ်များသည် ထို SRS ၏ ယူနစ်များနှင့် ကိုက်ညီနေမည်ဖြစ်သည်။ $perimeter function မှ ရရှိလာသည့် တွက်ချက်မှုများနှင့် မတူညီသည့်အချက်မှာ $perimeter သည် project ၏ ellipsoid setting နှင့် အကွာအဝေးယူနစ် setting များအတိုင်း စက်လုံးဆိုင်ရာ (ellipsoidal) တွက်ချက်မှုများကိုသာ ပြုလုပ်ခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	perimeter(geometry)
Argument များ	geometry - polygon ဂျီဩမေတြီ
ဥပမာများ	perimeter(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))')) → 12.0

13.2.13.101. point_n

ဤ function သည် ဂျီဩမေတြီတစ်ခုမှ သီးခြား node (ဆုံမှတ်) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	point_n(geometry, index)
Argument များ	geometry - ဂျီဩမေတြီ index - ပြန်ထုတ်ပေးမည့် node ၏ အညွှန်းကိန်းဖြစ်သည်။ 1 သည် ပထမဆုံး node ဖြစ်ပြီး အကယ်၍ တန်ဖိုးသည် အနုတ်လက္ခဏာဖြစ်ပါက ရွေးချယ်ထားသည့် မျဉ်းအဆစ် (vertex) အညွန်းကိန်း သည် ၎င်း၏ စုစုပေါင်းတန်ဖိုးထဲမှ ပကတိတန်ဖိုးကိုနုတ်ထားခြင်းဖြစ်သည်။ vertex - 0 မှ စတင်သည့် မျဉ်းအဆစ်အညွှန်းကိန်းဖြစ်သည်။ အကယ်၍ တန်ဖိုးသည် အနုတ်လက္ခဏာဖြစ်ပါက ရွေးချယ်ထားသည့် မျဉ်းအဆစ်အညွှန်းကိန်းသည် ၎င်း၏ စုစုပေါင်းတန်ဖိုးထဲမှ ပကတိတန်ဖိုးကိုနုတ်ထားခြင်းဖြစ်သည်။
ဥပမာများ	geom_to_wkt(point_n(geom_from_wkt('POLYGON((0 0, 4 0, 4 2, 0 2, 0 0))'),2)) → ‘Point (4 0)’

ထပ်မံဖတ်ရှုရန်- အလိုရှိရာ vertex များကို ထုတ်ယူခြင်း (Extract specific vertices) algorithm

13.2.13.102. point_on_surface

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏မျက်နှာပြင်ပေါ်တွင် အတိအကျတည်ရှိနေသည့် point တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	point_on_surface(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	point_on_surface(@geometry) → point ဂျီဩမေတြီတစ်ခု

ထပ်မံဖတ်ရှုရန်- မျက်နှာပြင်ပေါ်ရှိအမှတ် (Point on Surface) algorithm

13.2.13.103. pole_of_inaccessibility

ဤ function သည် မျက်နှာပြင်တစ်ခုအတွက် ခန့်မှန်း အလှမ်းဝေးသောဝင်ရိုး (pole of inaccessibility) ကို အနီးစပ်ဆုံးတွက်ချက်ပေးခြင်းဖြစ်ပြီး ၎င်းသည် မျက်နှာပြင်၏နယ်နိမိတ်မှ အဝေးဆုံးအတွင်းကျသော point ဖြစ်ပါသည်။ ဤ function သည် လက်ခံနိုင်မှု (tolerance) တစ်ခုအတွင်း အလှမ်းဝေးသော ဝင်ရိုးအမှန်ကို ရှာဖွေရာတွင် ကောင်းမွန်သည့် နည်းလမ်းတစ်ခုဖြစ်သည့် ‘polylabel’ နည်းလမ်း (Vladimir Agafonkin, 2016) ကို အသုံးပြုထားပါသည်။ ပိုမိုတိကျသည့် tolerance များသည် iteration (ထပ်ခါတလဲလဲပြုလုပ်ခြင်း) များများလိုအပ်မည်ဖြစ်ပြီး တွက်ချက်ရာတွင်လည်း ပိုမိုအချိန်ကြာမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	pole_of_inaccessibility(geometry, tolerance)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု tolerance - ဝင်ရိုးအမှန်တည်နေရာနှင့် ပြန်လည်ရရှိမည့် point အကြား အဝေးဆုံးအကွာအဝေး
ဥပမာများ	geom_to_wkt(pole_of_inaccessibility( geom_from_wkt('POLYGON((0 1, 0 9, 3 10, 3 3, 10 3, 10 1, 0 1))'), 0.1)) → ‘Point(1.546875 2.546875)’

ထပ်မံဖတ်ရှုရန်- မရောက်နိုင်သော ဝင်ရိုး (Pole of inaccessibility) algorithm

13.2.13.104. project

ဤ function သည် အကွာအဝေး ၊ လားရာ (azimuth) နှင့် radian ဖြင့်တိုင်းတာထားသော အမြင့်တို့ကို အသုံးပြု၍ စမှတ်တစ်ခုမှ ခန့်မှန်းနေရာချထား (project) သော point တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	project(point, distance, azimuth, [elevation]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	point - စတင်သည့် point distance - ခန့်မှန်းနေရာချမည့်အကွာအဝေး azimuth - radian ဖြင့် နာရီလက်တံအတိုင်းတိုင်းတာသည့် ဦးတည်ရာထောင့်ဖြစ်ပြီး၊ 0 သည် မြောက်အရပ်ကို ကိုယ်စားပြုပါသည် elevation - radian ဖြင့် တိုင်းတာသည့် စောင်းထောင့်
ဥပမာများ	geom_to_wkt(project(make_point(1, 2), 3, radians(270))) → ‘Point(-2, 2)’

ထပ်မံဖတ်ရှုရန်- Point နေရာချဖန်တီးခြင်း (Project points (Cartesian)) algorithm

13.2.13.105. relate

ဤ function သည် ဂျီဩမေတြီနှစ်ခုအကြား ဆက်စပ်မှု၏ Dimensional Extended 9 Intersection Model (DE-9IM)ကိုယ်စားပြုမှုကို စမ်းသပ်ခြင်းဖြစ်သည်။

Relationship variant (ဆက်စပ်မှုဆိုင်ရာမူကွဲ)

ဤ function သည် ဂျီဩမေတြီနှစ်ခုအကြား ဆက်စပ်မှု၏ Dimensional Extended 9 Intersection Model (DE-9IM) ကိုယ်စားပြုမှုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	relate(geometry, geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	relate( geom_from_wkt( 'LINESTRING(40 40,120 120)' ), geom_from_wkt( 'LINESTRING(40 40,60 120)' ) ) → ‘FF1F00102’

Pattern match variant (ပုံသဏ္ဍာန်ကိုက်ညီမှုဆိုင်ရာ မူကွဲ)

ဤ function သည် ဂျီဩမေတြီနှစ်ခုအကြား DE-9IM ဆက်စပ်မှု သည် သတ်မှတ်ထားသည့် pattern နှင့် ကိုက်ညီမှု ရှိ/မရှိကို စစ်ဆေးခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	relate(geometry, geometry, pattern)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု geometry - ဂျီဩမေတြီတစ်ခု pattern - ကိုက်ညီမှုရှိရမည့် DE-9IM pattern
ဥပမာများ	relate( geom_from_wkt( 'LINESTRING(40 40,120 120)' ), geom_from_wkt( 'LINESTRING(40 40,60 120)' ), '**1F001**' ) → TRUE

13.2.13.106. reverse

ဤ function သည် မျဉ်းကြောင်းတစ်ခုတွင်ရှိသော ၎င်း၏မျဉ်းအဆစ် (vertex) များ၏အစဉ်ကို ပြောင်းပြန်ပြုလုပ်ခြင်းဖြင့် ထိုမျဉ်းကြောင်း၏ဦးတည်ရာကို ပြောင်းပြန်ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	reverse(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(reverse(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘LINESTRING(2 2, 1 1, 0 0)’

ထပ်မံဖတ်ရှုရန်- line ဦးတည်ရာကိုပြောင်းပြန်လှည့်ခြင်း (Reverse line direction) algorithm

13.2.13.107. rotate

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ လှည့်နေသော ဗားရှင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများကို ထိုဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) ဖြင့် တွက်ချက်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	rotate(geometry, rotation, [center=NULL], [per_part=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု rotation - ဒီဂရီဖြင့် နာရီလက်တံအတိုင်းအလှည့် center - အလှည့်၏ အလယ်ဗဟိုအမှတ်ဖြစ်သည်။ အကယ်၍ သီးခြားမသတ်မှတ်ထားပါက ထို‌ဂျီဩမေတြီ၏ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) ၏ အလယ်ဗဟိုကို အသုံးပြုမည်ဖြစ်သည်။ per_part- အပိုင်းတစ်ခုစီတိုင်းတွင် လှည့်ခြင်းကို လုပ်ဆောင်ပါမည်။ ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီသည် အစိတ်အပိုင်းများစွာပါဝင်ပြီး အလှည့်၏အလယ်ဗဟိုအမှတ်ကိုလည်း တိတိကျကျသတ်မှတ်ထားခြင်းမရှိလျှင် လှည့်ခြင်းကို အပိုင်းတစ်ခုစီ၏ စတုဂံပုံအကျယ်အဝန်းနယ်၏ အလယ်ဗဟို ပတ်လည်တွင် လုပ်ဆောင်မည်ဖြစ်သည်။
ဥပမာများ	rotate(@geometry, 45, make_point(4, 5)) → (4, 5) point ပတ်လည်တွင် 45 ဒီဂရီ နာရီလက်တံအတိုင်း လှည့်ထားသော ဂျီဩမေတြီ rotate(@geometry, 45) → ၎င်း၏ bounding box ၏အလယ်ဗဟိုပတ်လည်တွင် 45 ဒီဂရီ နာရီလက်တံအတိုင်း လှည့်ထားသော ဂျီဩမေတြီ

Fig. 13.7 လည်နေသော feature များ

13.2.13.108. roundness

ဤ function တွင် polygon တစ်ခုသည် စက်ဝိုင်းပုံသဏ္ဍာန်ဖြစ်ရန် မည်မျှနီးစပ်သည်ကို တွက်ချက်ပေးခြင်းဖြစ်သည်။ Polygon သည် ပြီးပြည့်စုံသော စက်ဝိုင်းပုံသဏ္ဍာန်တစ်ခုဖြစ်လျှင် TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပြီး လုံးလုံးပြင်ညီဖြစ်နေသောအခါ 0 ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	roundness(geometry)
Argument များ	geometry - polygon တစ်ခု
ဥပမာများ	round(roundness(geom_from_wkt('POLYGON(( 0 0, 0 1, 1 1, 1 0, 0 0))')), 3) → 0.785 round(roundness(geom_from_wkt('POLYGON(( 0 0, 0 0.1, 1 0.1, 1 0, 0 0))')), 3) → 0.260

ထပ်မံဖတ်ရှုရန်- လုံးဝန်းမှု (Roundness) algorithm

13.2.13.109. scale

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ စကေးကိုက်ပြုလုပ်ထားသော ဗားရှင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်းဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	scale(geometry, x_scale, y_scale, [center]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု x_scale - x-ဝင်ရိုး စကေးကိုက် မြှောက်ဖော်ကိန်း y_scale - y-ဝင်ရိုး စကေးကိုက် မြှောက်ဖော်ကိန်း center - စကေးကိုက် အလယ်မှတ်ဖြစ်ပြီး အကယ်၍ သတ်မှတ်ထားခြင်းမရှိလျှင် ဂျီဩမေတြီ၏ စတုဂံပုံအကျယ်အဝန်းနယ် (bounding box) ၏ အလယ်မှတ်ကို အသုံးပြုသွားမည်ဖြစ်ပါသည်။
ဥပမာများ	scale(@geometry, 2, 0.5, make_point(4, 5)) → (4, 5) point ပတ်လည်တွင် ရေပြင်ညီအရ ၂ ဆ နှင့် ဒေါင်လိုက်အရ တဝက် စကေးကိုက်ပြုလုပ်ထားသော ဂျီဩမေတြီ scale(@geometry, 2, 0.5) → ၎င်း၏ bounding box ၏ အလယ်ဗဟိုပတ်လည်တွင် ရေပြင်ညီအရ ၂ ဆ နှင့် ဒေါင်လိုက်အရ တဝက် စကေးကိုက်ပြုလုပ်ထားသော ဂျီဩမေတြီ

13.2.13.110. segments_to_lines

ဤ function သည် ထည့်သွင်းလိုက်သော ဂျီဩမေတြီထဲရှိ မျဉ်းပိုင်းတိုင်းအတွက် line တစ်ခုစီပါဝင်သည့် multi line ဂျီဩမေတြီကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	segments_to_lines(geometry)
Argument များ	geometry - ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(segments_to_lines(geom_from_wkt('LINESTRING(0 0, 1 1, 2 2)'))) → ‘MultiLineString ((0 0, 1 1),(1 1, 2 2))’

ထပ်မံဖတ်ရှုရန်- Line များကို အပိုင်းပိုင်း ခွဲထုတ်ခြင်း (Explode lines) algorithm

13.2.13.111. shared_paths

ဤ function သည် ထည့်သွင်းလိုက်သော ဂျီဩမေတြီ နှစ်ခု မှ ဝေမျှအသုံးပြုထားသော လမ်းကြောင်းများအစုအစည်း တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တူညီသော လားရာသို့ဦးတည်နေသည့် လမ်းကြောင်းများမှာ စုစည်းမှု၏ ပထမ အရာ ဖြစ်ပြီး ဆန့်ကျင်ဘက် လားရာသို့ဦးတည်နေသည့် လမ်းကြောင်းများမှာ စုစည်းမှု၏ ဒုတိယ အရာ ဖြစ်ပါသည်။ လမ်းကြောင်းများကို ပထမ ဂျီဩမေတြီ၏ လားရာအတိုင်း သတ်မှတ်ပေးထားပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	shared_paths(geometry1, geometry2)
Argument များ	geometry1 - LineString/MultiLineString ဂျီဩမေတြီတစ်ခု geometry2 - LineString/MultiLineString ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt(shared_paths(geom_from_wkt('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),(51 150,101 150,76 175,51 150)))'),geom_from_wkt('LINESTRING(151 100,126 156.25,126 125,90 161, 76 175)'))) → ‘GeometryCollection (MultiLineString ((126 156.25, 126 125),(101 150, 90 161),(90 161, 76 175)),MultiLineString EMPTY)’ geom_to_wkt(shared_paths(geom_from_wkt('LINESTRING(76 175,90 161,126 125,126 156.25,151 100)'),geom_from_wkt('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),(51 150,101 150,76 175,51 150))'))) → ‘GeometryCollection (MultiLineString EMPTY,MultiLineString ((76 175, 90 161),(90 161, 101 150),(126 125, 126 156.25)))’

13.2.13.112. shortest_line

ဤ function သည် ဂျီဩမေတြီ (၁) နှင့် (၂) ကို ဆက်သွယ်ထားသော အတိုဆုံးမျဉ်းကို ပြန်ထုတ်ပေးပါသည်။ ရရှိလာမည့် မျဉ်းသည် ဂျီဩမေတြီ (၁) ၌ စတင်၍ (၂) ၌ အဆုံးသတ်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	shortest_line(geometry1, geometry2)
Argument များ	geometry1 - အတိုဆုံးမျဉ်းကို ရှာဖွေမည့် စတင်သည့် ဂျီဩမေတြီ geometry2 - အတိုဆုံးမျဉ်းကို ရှာဖွေမည့် အဆုံး ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(shortest_line(geom_from_wkt('LINESTRING (20 80, 98 190, 110 180, 50 75 )'),geom_from_wkt('POINT(100 100)'))) → ‘LineString(73.0769 115.384, 100 100)’

13.2.13.113. simplify

ဤ function သည် အကွာအဝေးကို အခြေခံသော ကန့်သတ်ချက်တစ်ခု (“Douglas Peucker” algorithm ကို ဆိုလိုပါသည်) ကို အသုံးပြု၍ node (အဆစ်) များကို ဖယ်ရှားပေးပြီး ဂျီဩမေတြီကို ရိုးရှင်းစေပါသည်။ ဤ algorithm သည် ဂျီဩမေတြီများတွင် ကြီးမားသော ကွဲလွဲမှုများ/သွေဖယ်မှုများကို ထိန်းသိမ်းထားပေးပြီး မျဉ်းဖြောင့်နီးပါးဖြစ်နေသော မျဉ်းပိုင်းများတွင် vertex များ၏ အရေအတွက်ကို လျှော့ချပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	simplify(geometry, tolerance)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု tolerance - ဖယ်ရှားရမည့် point များအတွက် အဖြောင့်မျဉ်းပိုင်းများမှ အများဆုံး ကွဲလွဲမှု/သွေဖယ်မှု
ဥပမာများ	geom_to_wkt(simplify(geometry:=geom_from_wkt('LineString(0 0, 5 0.1, 10 0)'),tolerance:=5)) → ‘LineString(0 0, 10 0)’

ထပ်မံဖတ်ရှုရန်- ပေါ့ပါးအောင်ပြုလုပ်ခြင်း (Simplify) algorithm

13.2.13.114. simplify_vw

ဤ function သည် ဧရိယာကို အခြေခံသော ကန့်သတ်ချက်တစ်ခု (“Visvalingam-Whyatt” algorithm ကို ဆိုလိုပါသည်) ကို အသုံးပြု၍ node များကို ဖယ်ရှားခြင်းဖြင့် ဂျီဩမေတြီကို ရိုးရှင်းစေပါသည်။ ဤ algorithm သည် ဂျီဩမေတြီများထဲတွင် သေးငယ်သော ဧရိယာလေးများကို ဖြစ်ပေါ်စေသည့် vertex များကို ဖယ်ရှားပေးပါသည်၊ ဥပမာ- ကျဉ်းမြောင်းသော ဆူးချွန်ပုံများ သို့မဟုတ် မျဉ်းဖြောင့်နီးပါးဖြစ်နေသော မျဉ်းပိုင်းများ။

Syntax (ဝါကျဖွဲ့ပုံ)	simplify_vw(geometry, tolerance)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု tolerance - node များကိုဖယ်ရှားရန်အတွက် node တစ်ခုမှဖန်တီးသော အများဆုံးဧရိယာအတိုင်းအတာ
ဥပမာများ	geom_to_wkt(simplify_vw(geometry:=geom_from_wkt('LineString(0 0, 5 0, 5.01 10, 5.02 0, 10 0)'),tolerance:=5)) → ‘LineString(0 0, 10 0)’

ထပ်မံဖတ်ရှုရန်- ပေါ့ပါးအောင်ပြုလုပ်ခြင်း (Simplify) algorithm

13.2.13.115. single_sided_buffer

ဤ function သည် မျဉ်းကြောင်း ဂျီဩမေတြီတစ်ခု၏ တစ်ဖက်တည်း၌သာ ကြားခံ (buffer) ပြုလုပ်၍ ဖြစ်ပေါ်လာသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကွာအဝေးများမှာ အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်းဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	single_sided_buffer(geometry, distance, [segments=8], [join=1], [miter_limit=2.0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - (multi)linestring ဂျီဩမေတြီတစ်ခု distance - ကြားခံအကွာအဝေး၊ အပေါင်းတန်ဖိုး များဖြစ်ပါက မျဉ်းကြောင်းများ၏ ဘယ်ဘက်သို့ ကြားခံပြုလုပ်မည်ဖြစ်ပြီး အနှုတ်တန်ဖိုးဖြစ်ပါက မျဉ်းကြောင်းများ၏ လက်ယာဘက်သို့ ကြားခံပြုလုပ်မည်ဖြစ်ပါသည်။ segments - လုံးဝန်းသော အဆက် (join) style ကို အသုံးပြုသောအခါတွင် စက်ဝိုင်း၏ လေးပုံတစ်ပုံ ကို ကိုယ်စားပြုရန် အသုံးပြုရမည့် မျဉ်းပိုင်းအရေအတွက်။ အရေအတွက်များလေလေ buffer တွင် node များပိုမိုပါလာပြီး ချောမွေ့လေဖြစ်ပါသည်။ ထိစပ်မှု - ထောင့်စွန်းများအတွက် အဆက် (join) style ဖြစ်ပြီး၊ 1 = round ၊ 2 = miter နှင့် 3 = bevel တို့ဖြစ်ပါသည်။ miter_limit - အလွန်ချွန်သော ထောင့်စွန်းများအတွက် အသုံးပြုသော miter အချိုးကန့်သတ်ချက် (miter join ကို အသုံးပြုသည့်အခါအတွက်သာ ဖြစ်ပါသည်)
ဥပမာများ	single_sided_buffer(@geometry, 10.5) → ဘယ်ဘက်သို့ 10.5 ယူနစ်ဖြင့် ကြားခံပြုလုပ်ထားသည့် မျဉ်းကြောင်း single_sided_buffer(@geometry, -10.5) → ညာဘက်သို့ 10.5 ယူနစ်ဖြင့် ကြားခံပြုလုပ်ထားသည့် မျဉ်းကြောင်း single_sided_buffer(@geometry, 10.5, segments:=16, join:=1) → ပိုမိုချောမွေ့သော ကြားခံရရှိစေရန် မျဉ်းပိုင်းများစွာ အသုံးပြုထားပြီး ဘယ်ဘက်သို့ 10.5 ယူနစ်ဖြင့် ကြားခံပြုလုပ်ထားသည့် မျဉ်းကြောင်း single_sided_buffer(@geometry, 10.5, join:=3) → beveled join ကို အသုံးပြုထားပြီး ဘယ်ဘက်သို့ 10.5 ယူနစ်ဖြင့် ကြားခံပြုလုပ်ထားသည့် မျဉ်းကြောင်း

ထပ်မံဖတ်ရှုရန်- တစ်ဖက်ရပ် ကြားခံဇုံ (Single sided buffer) algorithm

13.2.13.116. sinuosity

ဤ function သည် မျဉ်းကွေးတစ်ခု၏ အကွေးပမာဏ ကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် အကွေးအလျားနှင့် အဆိုပါမျဉ်း၏ အဆုံးမှတ်များကြား မျဉ်းဖြောင့် (2D) အကွာအဝေးတို့ကို အချိုးချထားခြင်းဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sinuosity(geometry)
Argument များ	geometry - ထည့်သွင်းသော မျဉ်းကွေး (စက်ဝိုင်းပုံ မျဉ်းကြောင်း၊ မျဉ်းကြောင်း)
ဥပမာများ	round(sinuosity(geom_from_wkt('LINESTRING(2 0, 2 2, 3 2, 3 3)')), 3) → 1.265 sinuosity(geom_from_wkt('LINESTRING( 3 1, 5 1)')) → 1.0

13.2.13.117. smooth

ဤ function သည် ဂျီဩမေတြီတစ်ခုတွင် ထောင့်စွန်းများကို လုံးဝန်းစေသော node အပိုများကို ထည့်သွင်းခြင်းဖြင့် ဂျီဩမေတြီတစ်ခုကို ချောမွေ့စေပါသည်။ ထည့်သွင်းလိုက်သော ဂျီဩမေတြီတွင် Z သို့မဟုတ် M တန်ဖိုးများ ပါဝင်နေလျှင် အဆိုပါအရာများပါ ချောမွေ့သွားမည်ဖြစ်ပြီး ရလာဒ် ဂျီဩမေတြီသည် ထည့်သွင်းလိုက်သော ဂျီဩမေတြီကဲ့သို့ပင် တူညီသောအတိုင်းအတာများ ဆက်လက်ကျန်ရှိမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	smooth(geometry, [iterations=1], [offset=0.25], [min_length=-1], [max_angle=180]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု iterations - လုပ်ဆောင်မည့် ချောမွေ့ခြင်း ထပ်ခါတလဲလဲဆောင်ရွက်မှု အကြိမ်အရေအတွက်ဖြစ်ပြီး၊ ကိန်းဂဏန်းကြီးလေလေ ပိုမိုချောမွေ့သောရလာဒ်ကို ရရှိလေဖြစ်သော်လည်း ဂျီဩမေတြီကို ပိုမိုရှုပ်ထွေးစေပါသည်။ offset - ချောမွေ့အောင်လုပ်ထားသော ဂျီဩမေတြီသည် မူလဂျီဩမေတြီအတိုင်း မည်မျှနီးနီးကပ်ကပ်ဖြစ်ရမည်ကို ထိန်းချုပ်ပေးသော (0) နှင့် (0.5) အကြားရှိ တန်ဖိုးဖြစ်ပါသည်။ ပိုမိုသေးငယ်သောတန်ဖိုးများသည် ပိုမိုနီးစပ်စွာ ချောမွေ့စေမည်ဖြစ်ပြီး ပိုမိုကြီးမားသော တန်ဖိုးများသည် နီးစပ်မှုလျော့နည်းသော ချောမွေ့မှုကို ရရှိစေပါသည်။ min_length - ချောမွေ့အောင်လုပ်ဆောင်ခြင်းတွင်အသုံးပြုမည့် မျဉ်းပိုင်းများ၏ အနည်းဆုံးအလျား ဖြစ်ပါသည်။ ဂျီဩမေတြီ၏ တိုသော မျဉ်းပိုင်းများတွင် များပြားသော node အပိုများ ထပ်ထည့်ခြင်းကို ရှောင်ရှားရန် ဤ parameter ကို အသုံးပြုနိုင်ပါသည်။ max_angle - ချောမွေ့စေခြင်းအတွက် လုပ်ဆောင်ရာတွင် node တွင်အသုံးပြုမည့် အကြီးဆုံးထောင့် (0 မှ 180 အတွင်း) ဖြစ်ပါသည်။ ရည်ရွယ်ချက်ရှိရှိဖြင့် အကြီးဆုံးထောင့်တန်ဖိုးကို လျှော့ချ ပေးခြင်းဖြင့် ဂျီဩမေတြီများရှိ ချွန်ထက်သော ထောင့်စွန်းများကို ထိန်းသိမ်းထားပေးနိုင်မည် ဖြစ်ပါသည်။ ဥပမာအားဖြင့် 80 ဒီဂရီတန်ဖိုးသည် ဂျီဩမေတြီထဲရှိ ဒေါင့်မှန် ထောင့်များကို ထိန်းသိမ်းပေးထားမည်ဖြစ်သည်။
ဥပမာများ	geom_to_wkt(smooth(geometry:=geom_from_wkt('LineString(0 0, 5 0, 5 5)'),iterations:=1,offset:=0.2,min_length:=-1,max_angle:=180)) → ‘LineString (0 0, 4 0, 5 1, 5 5)’

ထပ်မံဖတ်ရှုရန်- ချောမွေ့စေခြင်း (Smooth) algorithm

13.2.13.118. square_wave

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက် စတုရန်းပုံ/စတုဂံပုံ လှိုင်းတွန့်များ တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	square_wave(geometry, wavelength, amplitude, [strict=False]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု wavelength - စတုရန်း လှိုင်းတွန့်ပုံ၏ လှိုင်းအလျား (wavelength) amplitude - စတုရန်း လှိုင်းတွန့်ပုံ၏ လှိုင်းလွှဲကျယ် (amplitude) strict - Default အားဖြင့် လှိုင်းအလျား argument ကို “maximum wavelength” အဖြစ် ပြုမူပါသည်၊ ဤတွင် ဂျီဩမေတြီ၏ နယ်နိမိတ်တလျှောက်တွင် စတုရန်းပုံလှိုင်းတွန့် အရေအတွက် အတိအကျ ဖန်တီးနိုင်စေရန် အမှန်တကယ်ရှိသော လှိုင်းအလျား ကို ပြောင်းလဲညှိနှိုင်း ပေးလိမ့်မည်ဖြစ်ပါသည်။ အကယ်၍ strict argument ကို true ဟု သတ်မှတ်လိုက်ပါက လှိုင်းအလျားကို အတိအကျအသုံးပြုလိမ့်မည် ဖြစ်ပြီး နောက်ဆုံးလှိုင်းတွန့်ပုံအတွက် မပြည့်စုံသော pattern ကို အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	square_wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1) → မျဉ်းကြောင်းတလျှောက် wavelength 3 နှင့် amplitude 1 ရှိသော စတုရန်းလှိုင်းတွန့်များ

13.2.13.119. square_wave_randomized

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက်တွင် ကျပန်းဖြစ်နေသော စတုရန်း/စတုဂံ ပုံ လှိုင်းတွန့်များကို တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	square_wave_randomized(geometry, min_wavelength, max_wavelength, min_amplitude, max_amplitude, [seed=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု min_wavelength - လှိုင်းတွန့်များ၏ အငယ်ဆုံး လှိုင်းအလျား max_wavelength - လှိုင်းတွန့်များ၏ အကြီးဆုံး လှိုင်းအလျား min_amplitude - လှိုင်းတွန့်များ၏ အငယ်ဆုံး လှိုင်းလွှဲကျယ် max_amplitude - လှိုင်းတွန့်များ၏ အကြီးဆုံး လှိုင်းလွှဲကျယ် seed - လှိုင်းတွန့်များရရှိရန် ကျပန်း အစပျိုးမှု (seed) တစ်ခုကို သတ်မှတ်ပေးပါသည်။ အကယ်၍ seed သည် 0 ဖြစ်နေလျှင် လုံးဝကျပန်းဖြစ်နေသော လှိုင်းတွန့်များအစုကို ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	square_wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2) → မျဉ်းကြောင်းတလျှောက် wavelength 2 နှင့် 3 အကြားရှိပြီး amplitude 0.1 နှင့် 0.2 အကြားရှိသော ကျပန်းအရွယ်အစား စတုရန်းလှိုင်းတွန့်များ

13.2.13.120. start_point

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ ပထမဆုံး ဆုံမှတ် (node) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	start_point(geometry)
Argument များ	geometry - ဂျီဩမေတြီ
ဥပမာများ	geom_to_wkt(start_point(geom_from_wkt('LINESTRING(4 0, 4 2, 0 2)'))) → ‘Point (4 0)’

ထပ်မံဖတ်ရှုရန်- အလိုရှိရာ vertex များကို ထုတ်ယူခြင်း (Extract specific vertices) algorithm

13.2.13.121. straight_distance_2d

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ ပထမဆုံးနှင့် နောက်ဆုံး မျဉ်းအဆစ် (vertex) များအကြား တိုက်ရိုက်/ပြင်ညီအကွာအဝေးကို ပြန်ထုတ်ပေးပါသည်။ ဂျီဩမေတြီသည် မျဉ်းကွေးတစ်ခု (စက်ဝိုင်းပုံမျဉ်း၊ မျဉ်းကြောင်း) ဖြစ်ရပါမည်။

Syntax (ဝါကျဖွဲ့ပုံ)	straight_distance_2d(geometry)
Argument များ	geometry - ဂျီဩမေတြီ
ဥပမာများ	straight_distance_2d(geom_from_wkt('LINESTRING(1 0, 1 1)')) → 1 round(straight_distance_2d(geom_from_wkt('LINESTRING(1 4, 3 5, 5 0)')), 3) → 5.657

ထပ်မံဖတ်ရှုရန်- length

13.2.13.122. sym_difference

ဤ function သည် ထိဖြတ်ခြင်းမရှိသည့် ဂျီဩမေတြီနှစ်ခု၏ အပိုင်းများကို ကိုယ်စားပြုသော ဂျီဩမေတြီ တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sym_difference(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( sym_difference( geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ), geom_from_wkt( 'LINESTRING(3 3, 8 8)' ) ) ) → ‘LINESTRING(5 5, 8 8)’

ထပ်မံဖတ်ရှုရန်- အချိုးညီ ခြားနားမှု (Symmetrical difference) algorithm

13.2.13.123. tapered_buffer

ဤ function သည် line ဂျီဩမေတြီ တလျှောက်တွင် buffer တစ်ခုကို ဖန်တီးပေးပြီး buffer ၏အချင်းသည် line ၏ အလျားပေါ်မူတည်၍ ညီတူညီမျှ ပြောင်းလဲပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	tapered_buffer(geometry, start_width, end_width, [segments=8]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ထည့်သွင်းလိုက်သည့် ဂျီဩမေတြီဖြစ်ပြီး (multi)line ဂျီဩမေတြီတစ်ခု ဖြစ်ရပါမည်။ start_width - မျဉ်းကြောင်း၏အစ၌ ရှိသော buffer ၏ အကျယ် end_width - မျဉ်းကြောင်း ၏ အဆုံး၌ ရှိသော buffer ၏ အကျယ် segments - Buffer တွင်း စက်ဝိုင်း၏လေးပုံတစ်ပုံ မျဉ်းကွေးကို အနီးစပ်ဆုံးရရှိစေရန် မျဉ်းပိုင်းများ အရေအတွက်
ဥပမာများ	tapered_buffer(geometry:=geom_from_wkt('LINESTRING(1 2, 4 2)'),start_width:=1,end_width:=2,segments:=8) → Line ဂျီဩမေတြီတလျှောက် အချင်း 1 နှင့်စပြီး အဆုံးသတ်တွင် အချင်း 2 ဖြင့် အဆုံးသတ်သည့် အဖျားချွန် buffer တစ်ခု

Fig. 13.8 Line feature များပေါ်ရှိ အဖျားချွန် buffer

ထပ်မံဖတ်ရှုရန်- အဖျားရှူးကြားခံဇုံများ (Tapered buffers) algorithm

13.2.13.124. touches

ဤ function တွင် ဂျီဩမေတြီတစ်ခုသည် အခြားတစ်ခုကို ထိနေခြင်း ရှိ/မရှိ စစ်ဆေးပေးပြီး အကယ်၍ ဂျီဩမေတြီများသည် အတွင်းပိုင်းများ မထိဖြတ်သော်လည်း အနည်းဆုံး ဘုံတူညီနေသော point တစ်ခုရှိနေလျှင် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	touches(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	touches( geom_from_wkt( 'LINESTRING(5 3, 4 4)' ), geom_from_wkt( 'LINESTRING(3 3, 4 4, 5 5)' ) ) → TRUE touches( geom_from_wkt( 'POINT(4 4)' ), geom_from_wkt( 'POINT(5 5)' ) ) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_touches

13.2.13.125. transform

ဤ function သည် မူလအရင်းအမြစ် CRS တစ်ခုမှ လိုချင်သည့် (destination) CRS တစ်ခုသို့ ပြောင်းလဲထားသော ဂျီဩမေတြီတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	transform(geometry, source_auth_id, dest_auth_id)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု source_auth_id - အရင်းအမြစ် မူပိုင် CRS ID dest_auth_id - လိုချင်သည့် မူပိုင် CRS ID
ဥပမာများ	geom_to_wkt( transform( make_point(488995.53240249, 7104473.38600835), 'EPSG:2154', 'EPSG:4326' ) ) → ‘POINT(0 51)’

ထပ်မံဖတ်ရှုရန်- Layer ကို projection ပြောင်းခြင်း (Reproject layer) algorithm

13.2.13.126. translate

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ ရွှေ့ပြောင်းထားသော ဗားရှင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများမှာ အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်းဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	translate(geometry, dx, dy)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု dx - delta x dy - delta y
ဥပမာများ	translate(@geometry, 5, 10) → မူရင်းဂျီဩမေတြီနှင့် အမျိုးအစားတူညီသော ဂျီဩမေတြီတစ်ခု

Fig. 13.9 ရွှေ့ပြောင်းထားသော feature များ

ထပ်မံဖတ်ရှုရန်- နေရာရွှေ့ခြင်း (Translate) algorithm

13.2.13.127. triangular_wave

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက်တွင် တြိဂံပုံလှိုင်းတွန့်များ တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	triangular_wave(geometry, wavelength, amplitude, [strict=False]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု wavelength - တြိဂံလှိုင်းတွန့်ပုံ၏ လှိုင်းအလျား amplitude - တြိဂံလှိုင်းတွန့်ပုံ၏ လှိုင်းလွှဲကျယ် strict - Default အားဖြင့် လှိုင်းအလျား argument ကို “maximum wavelength” အဖြစ် ပြုမူပါသည်၊ ဤတွင် ဂျီဩမေတြီ၏ နယ်နိမိတ်တလျှောက်တွင် တြိဂံပုံလှိုင်းတွန့် အရေအတွက် အတိအကျ ဖန်တီးနိုင်စေရန် အမှန်တကယ်ရှိသော လှိုင်းအလျား ကို ပြောင်းလဲညှိနှိုင်း ပေးလိမ့်မည်ဖြစ်ပါသည်။ အကယ်၍ strict argument ကို true ဟု သတ်မှတ်လိုက်ပါက လှိုင်းအလျားကို အတိအကျအသုံးပြုလိမ့်မည် ဖြစ်ပြီး နောက်ဆုံးလှိုင်းတွန့်ပုံအတွက် မပြည့်စုံသော pattern ကို အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	triangular_wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1) → Linestring တလျှောက် wavelength 3 နှင့် amplitude 1 ရှိသော တြိဂံပုံလှိုင်းတွန့်များ

13.2.13.128. triangular_wave_randomized

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက်တွင် ကျပန်းဖြစ်နေသော တြိဂံပုံ လှိုင်းတွန့်များကို တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	triangular_wave_randomized(geometry, min_wavelength, max_wavelength, min_amplitude, max_amplitude, [seed=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု min_wavelength - လှိုင်းတွန့်များ၏ အငယ်ဆုံး လှိုင်းအလျား max_wavelength - လှိုင်းတွန့်များ၏ အကြီးဆုံး လှိုင်းအလျား min_amplitude - လှိုင်းတွန့်များ၏ အငယ်ဆုံး လှိုင်းလွှဲကျယ် max_amplitude - လှိုင်းတွန့်များ၏ အကြီးဆုံး လှိုင်းလွှဲကျယ် seed - လှိုင်းတွန့်များရရှိရန် ကျပန်း အစပျိုးမှု (seed) တစ်ခုကို သတ်မှတ်ပေးပါသည်။ အကယ်၍ seed သည် 0 ဖြစ်နေလျှင် လုံးဝကျပန်းဖြစ်နေသော လှိုင်းတွန့်များအစုကို ထုတ်ပေးမည်ဖြစ်ပါသည်။
ဥပမာများ	triangular_wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2) → Linestring တလျှောက် wavelength 2 နှင့် 3 ကြားရှိပြီး amplitude 0.1 နှင့် 0.2 ကြားရှိသော ကျပန်းအရွယ်အစားရှိသည့် တြိဂံပုံလှိုင်းတွန့်များ

13.2.13.129. union

ဤ function သည် ဂျီဩမေတြီများ၏ ပေါင်းစည်းမှု အမှတ်အစုကို ကိုယ်စားပြုသည့် ဂျီဩမေတြီကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	union(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	geom_to_wkt( union( make_point(4, 4), make_point(5, 5) ) ) → ‘MULTIPOINT(4 4, 5 5)’

13.2.13.130. wave

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက် လုံးဝန်းသော (ပုံမှန် အတက်အကျဖြစ်နေသည့် (sine-like)) လှိုင်းများကို တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	wave(geometry, wavelength, amplitude, [strict=False]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု wavelength - ပုံမှန် အတက်အကျဖြစ်နေသည့် (sine-like) လှိုင်းတွန့်၏ လှိုင်းအလျား amplitude - ပုံမှန် အတက်အကျဖြစ်နေသည့် (sine-like) လှိုင်းတွန့်၏ လှိုင်းလွှဲကျယ် strict - Default အားဖြင့် လှိုင်းအလျား argument ကို “maximum wavelength” အဖြစ် ပြုမူပါသည်၊ ဤတွင် ဂျီဩမေတြီ၏ နယ်နိမိတ်တလျှောက်တွင် လှိုင်းတွန့် အရေအတွက် အတိအကျ ဖန်တီးနိုင်စေရန် အမှန်တကယ်ရှိသော လှိုင်းအလျား ကို ပြောင်းလဲညှိနှိုင်းပေးလိမ့်မည်ဖြစ်ပါသည်။ အကယ်၍ strict argument ကို true ဟု သတ်မှတ်လိုက်ပါက လှိုင်းအလျားကို အတိအကျအသုံးပြုလိမ့်မည် ဖြစ်ပြီး နောက်ဆုံးလှိုင်းတွန့်ပုံအတွက် မပြည့်စုံသော pattern ကို အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	wave(geom_from_wkt('LineString(0 0, 10 0)'), 3, 1) → Linestring တလျှောက် wavelength 3 နှင့် amplitude 1 ရှိသော ပုံမှန် အတက်အကျဖြစ်နေသည့် (sine-like) လှိုင်းတွန့်များ

13.2.13.131. wave_randomized

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ နယ်နိမိတ်တလျှောက် တွင် ကျပန်းဖြစ်နေသော မျဉ်းကွေး (sine-like) လှိုင်းတွန့်များကို တည်ဆောက်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	wave_randomized(geometry, min_wavelength, max_wavelength, min_amplitude, max_amplitude, [seed=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု min_wavelength - လှိုင်းများ၏ အငယ်ဆုံးလှိုင်းအလျား max_wavelength - လှိုင်းများ၏ အကြီးဆုံးလှိုင်းအလျား min_amplitude - လှိုင်းများ၏ အငယ်ဆုံးလှိုင်းလွှဲကျယ် max_amplitude - လှိုင်းများ၏ အကြီးဆုံး လှိုင်းလွှဲကျယ် seed - လှိုင်းတွန့်များ ထုတ်ပေးခြင်းအတွက် ကျပန်း အစပျိုးမှု (seed) တစ်ခုကို သတ်မှတ်ပေးပါသည်။ အကယ်၍ seed သည် 0 ဖြစ်နေလျှင် လုံးဝကျပန်းဖြစ်နေသော လှိုင်းတွန့်များအစုတစ်ခုကို ထုတ်လုပ်ပေးပါသည်။
ဥပမာများ	wave_randomized(geom_from_wkt('LineString(0 0, 10 0)'), 2, 3, 0.1, 0.2) → မျဉ်းကြောင်းတလျှောက် wavelength 2 နှင့် 3 ကြားရှိပြီး amplitude 0.1 နှင့် 0.2 ကြားရှိသည့် ကျပန်းအရွယ်အစား မျဉ်းကွေးသဏ္ဍာန်လှိုင်းတွန့်များ

13.2.13.132. wedge_buffer

ဤ function သည် point ဂျီဩမေတြီတစ်ခုမှ အစပြုလာသော သပ်ပုံသဏ္ဍာန် ကြားခံဧရိယာတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	wedge_buffer(center, azimuth, width, outer_radius, [inner_radius=0.0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်သည်
Argument များ	center - ကြားခံဧရိယာ၏ (အစပြုရာ) အလယ်မှတ်၊ point ဂျီဩမေတြီဖြစ်ရပါမည်။ azimuth - Point သို့ သပ်ပုံ၏အလယ်အတွက် ထောင့် (ဒီဂရီဖြင့်) width - ကြားခံဧရိယာအကျယ် (ဒီဂရီဖြင့်)၊ သပ်ပုံသည် ဦးတည်ရာထောင့်၏ လားရာတစ်ဖက်စီတွင် ထောင့်၏အကျယ်၏ တဝက်သို့ တိုးချဲ့ ပေလိမ့်မည်။ outer_radius - ကြားခံဧရိယာအတွက် အပြင်ပိုင်းအချင်းဝက် inner_radius - ရွေးချယ်ခွင့်ရှိသော ကြားခံဧရိယာအတွက် အတွင်းပိုင်းအချင်းဝက်
ဥပမာများ	wedge_buffer(center:=geom_from_wkt('POINT(1 2)'),azimuth:=90,width:=180,outer_radius:=1) → point (1,2) ကို ဗဟိုအဖြစ်သတ်မှတ်ထားသည့် သပ်ပုံကြားခံတစ်ခုဖြစ်ပြီး ၎င်းသည် အရှေ့ဘက်ကို မျက်နှာမူ၍ အကျယ်မှာ 180 ဒီဂရီရှိပြီး အပြင်အချင်းဝက်မှာ 1 ဖြစ်သည်

ထပ်မံဖတ်ရှုရန်- သပ်ပုံစံ buffer များ ဖန်တီးခြင်း (Create wedge buffers) algorithm

13.2.13.133. within

ဤ function သည် ဂျီဩမေတြီတစ်ခုသည် အခြားတစ်ခုအတွင်း ကျရောက်နေခြင်း ရှိ/မရှိ စစ်ဆေးပေးပါသည်။ ဂျီဩမေတြီ(၁) သည် ဂျီဩမေတြီ(၂) အတွင်း လုံးဝကျရောက်နေလျှင် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	within(geometry1, geometry2)
Argument များ	geometry1 - ဂျီဩမေတြီတစ်ခု geometry2 - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	within( geom_from_wkt( 'POINT( 0.5 0.5)' ), geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))' ) ) → TRUE within( geom_from_wkt( 'POINT( 5 5 )' ), geom_from_wkt( 'POLYGON((0 0, 0 1, 1 1, 1 0, 0 0 ))' ) ) → FALSE

ထပ်မံဖတ်ရှုရန်- overlay_within

13.2.13.134. $x

ဤ function သည် လက်ရှိအသုံးပြုနေသော point feature ၏ x ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ feature သည် point များစွာပါဝင်သော feature ဖြစ်နေပါက ပထမဆုံး point ၏ x ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ WARNING (သတိပေးချက်)- ဤ function သည် အပြစ်အနာအဆာပါရှိနေပါသည်။ @geometry variable အစား x() function ကို အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$x
ဥပမာများ	$x → 42

ထပ်မံဖတ်ရှုရန်- x

13.2.13.135. x

ဤ function သည် point ဂျီဩမေတြီတစ်ခု၏ x ကိုဩဒိနိတ် သို့မဟုတ် point မဟုတ်သော ဂျီဩမေတြီတစ်ခုအတွက် အလယ်ဗဟိုမှတ် (centroid) ၏ x ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	x(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	x( geom_from_wkt( 'POINT(2 5)' ) ) → 2 x( @geometry ) → လက်ရှိ feature ၏ အလယ်ဗဟိုရှိ x ကိုဩဒိနိတ်

13.2.13.136. $x_at

ဤ function သည် လက်ရှိအသုံးပြုနေသော feature ဂျီဩမေတြီ၏ x ကိုဩဒိနိတ်ကိုရရှိစေပါသည်။ WARNING(သတိပေးချက်) - ဤလုပ်ဆောင်ချက်သည် အပြစ်အနာအဆာ ပါရှိနေပါသည်။ @geometry variable အစား x_at function ဖြင့် အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$x_at(vertex)
Argument များ	vertex - လက်ရှိအသုံးပြုနေသော ဂျီဩမေတြီ၏ မျဉ်းဆစ် အညွှန်းကိန်း (အညွှန်းကိန်းမှာ (0)မှစတင်ပြီး ၊ နောက်ဆုံးအညွှန်းကိန်းမှဆိုလျှင် အနှုတ်တန်ဖိုးကို အသုံးပြုပါသည်၊ (-1) မှ စတင်ပါသည်)
ဥပမာများ	$x_at(1) → 5

ထပ်မံဖတ်ရှုရန်- x_at

13.2.13.137. x_at

ဤ function သည် ဂျီဩမေတြီ၏ x ကိုဩဒိနိတ်ကို ရယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	x_at(geometry, vertex)
Argument များ	geometry - ဂျီဩမေတြီ vertex - ဂျီဩမေတြီ၏ မျဉ်းဆစ် အညွှန်းကိန်း (အညွှန်းကိန်းမှာ (0)မှစတင်ပြီး ၊ နောက်ဆုံးအညွှန်းကိန်းမှဆိုလျှင် အနှုတ်တန်ဖိုးကို အသုံးပြုပါသည်၊ (-1) မှ စတင်ပါသည်)
ဥပမာများ	x_at( geom_from_wkt( 'POINT(4 5)' ), 0 ) → 4

13.2.13.138. x_max

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အကြီးဆုံး x ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	x_max(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	x_max( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 4

13.2.13.139. x_min

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အငယ်ဆုံး x ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် အဆိုပါ ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	x_min(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	x_min( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 2

13.2.13.140. $y

ဤ function သည် လက်ရှိအသုံးပြုနေသော point feature ၏ y ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ point များစွာပါသော feature တစ်ခု ဖြစ်နေလျှင် ပထမဆုံး point ၏ y ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ WARNING(သတိပေးချက်)- ဤ function သည် အပြစ်အနာဆာပါရှိနေပါသည်။ @geometry variable အစား y() function ဖြင့် အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$y
ဥပမာများ	$y → 42

ထပ်မံဖတ်ရှုရန်- y

13.2.13.141. y

ဤ function သည် point ဂျီဩမေတြီတစ်ခု၏ y ကိုဩဒိနိတ် သို့မဟုတ် point မဟုတ်သော ဂျီဩမေတြီတစ်ခုအတွက် အလယ်ဗဟို (centroid) ၏ y ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	y(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	y( geom_from_wkt( 'POINT(2 5)' ) ) → 5 y( @geometry ) → လက်ရှိ feature ၏ အလယ်ဗဟိုရှိ y ကိုဩဒိနိတ်

13.2.13.142. $y_at

ဤ function သည် လက်ရှိအသုံးပြုနေသော feature ဂျီဩမေတြီ၏ y ကိုဩဒိနိတ်ကို ရယူပေးပါသည်။ WARNING(သတိပေးချက်) - ဤ function သည် အပြစ်အနာဆာပါရှိနေပါသည်။ @geometry variable အစား y_at function ဖြင့် အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$y_at(vertex)
Argument များ	vertex - လက်ရှိအသုံးပြုနေသော ဂျီဩမေတြီ၏ မျဉ်းဆစ် အညွှန်းကိန်း (အညွှန်းကိန်းမှာ (0)မှစတင်ပြီး ၊ နောက်ဆုံးအညွှန်းကိန်းမှဆိုလျှင် အနှုတ်တန်ဖိုးကို အသုံးပြုပါသည်၊ (-1) မှ စတင်ပါသည်)
ဥပမာများ	$y_at(1) → 2

ထပ်မံဖတ်ရှုရန်- y_at

13.2.13.143. y_at

ဤ function သည် ဂျီဩမေတြီ၏ y ကိုဩဒိနိတ်ကို ရယူပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	y_at(geometry, vertex)
Argument များ	geometry - ဂျီဩမေတြီ vertex - ဂျီဩမေတြီ၏ မျဉ်းဆစ် အညွှန်းကိန်း (အညွှန်းကိန်းမှာ (0)မှစတင်ပြီး ၊ နောက်ဆုံးအညွှန်းကိန်းမှဆိုလျှင် အနှုတ်တန်ဖိုးကို အသုံးပြုပါသည်၊ (-1) မှ စတင်ပါသည်)
ဥပမာများ	y_at( geom_from_wkt( 'POINT(4 5)' ), 0 ) → 5

13.2.13.144. y_max

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အကြီးဆုံး y ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	y_max(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	y_max( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 8

13.2.13.145. y_min

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အငယ်ဆုံး y ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်။ တွက်ချက်မှုများသည် ဂျီဩမေတြီ၏ တည်နေရာရည်ညွှန်းစနစ် (SRS) အတိုင်း ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	y_min(geometry)
Argument များ	geometry - ဂျီဩမေတြီတစ်ခု
ဥပမာများ	y_min( geom_from_wkt( 'LINESTRING(2 5, 3 6, 4 8)') ) → 5

13.2.13.146. $z

ဤ function သည် လက်ရှိအသုံးပြုနေသော point feature သည် 3D ဖြစ်ပါက z တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ feature သည် multipoint feature ဖြစ်ပါက ပထမဆုံးအမှတ်၏ z တန်ဖိုးကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ WARNING(သတိပေးချက်)- ဤ functin သည် အပြစ်အနာအဆာပါနေပါသည်။ @geometry variable အစား z() function ဖြင့် အစားထိုးအသုံးပြုရန် အကြံပြုပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$z
ဥပမာများ	$z → 123

13.2.13.147. z

ဤ function သည် point ဂျီဩမေတြီတစ်ခု၏ z ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပြီး အကယ်၍ ဂျီဩမေတြီတွင် z တန်ဖိုးမရှိပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	z(geometry)
Argument များ	geometry - Point ဂျီဩမေတြီတစ်ခု
ဥပမာများ	z( geom_from_wkt( 'POINTZ(2 5 7)' ) ) → 7

13.2.13.148. z_at

ဤ function သည် ဂျီဩမေတြီ၏ z ကိုဩဒိနိတ်ကို ရယူပေးပါသည်။ သို့မဟုတ် ဂျီဩမေတြီတွင် z တန်ဖိုး မပါရှိပါက NULL ကို ရရှိစေမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	z_at(geometry, vertex)
Argument များ	geometry - ဂျီဩမေတြီ vertex - ဂျီဩမေတြီ၏ မျဉ်းဆစ် အညွှန်းကိန်း (အညွှန်းကိန်းမှာ (0)မှစတင်ပြီး ၊ နောက်ဆုံးအညွှန်းကိန်းမှဆိုလျှင် အနှုတ်တန်ဖိုးကို အသုံးပြုပါသည်၊ (-1) မှ စတင်ပါသည်)
ဥပမာများ	z_at(geom_from_wkt('LineStringZ(0 0 0, 10 10 5, 10 10 0)'), 1) → 5

13.2.13.149. z_max

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အများဆုံး z ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပြီး အကယ်၍ ဂျီဩမေတြီတွင် z တန်ဖိုးမပါရှိလျှင် NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	z_max(geometry)
Argument များ	geometry - z ကိုဩဒိနိတ်ပါသော ဂျီဩမေတြီတစ်ခု
ဥပမာများ	z_max( geom_from_wkt( 'POINT ( 0 0 1 )' ) ) → 1 z_max( geom_from_wkt( 'MULTIPOINT ( 0 0 1 , 1 1 3 )' ) ) → 3 z_max( make_line( make_point( 0,0,0 ), make_point( -1,-1,-2 ) ) ) → 0 z_max( geom_from_wkt( 'LINESTRING( 0 0 0, 1 0 2, 1 1 -1 )' ) ) → 2 z_max( geom_from_wkt( 'POINT ( 0 0 )' ) ) → NULL

13.2.13.150. z_min

ဤ function သည် ဂျီဩမေတြီတစ်ခု၏ အနည်းဆုံး z ကိုဩဒိနိတ်ကို ပြန်ထုတ်ပေးပြီး အကယ်၍ ဂျီဩမေတြီတွင် z တန်ဖိုးမပါရှိလျှင် NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	z_min(geometry)
Argument များ	geometry - z ကိုဩဒိနိတ်ပါသော ဂျီဩမေတြီတစ်ခု
ဥပမာများ	z_min( geom_from_wkt( 'POINT ( 0 0 1 )' ) ) → 1 z_min( geom_from_wkt( 'MULTIPOINT ( 0 0 1 , 1 1 3 )' ) ) → 1 z_min( make_line( make_point( 0,0,0 ), make_point( -1,-1,-2 ) ) ) → -2 z_min( geom_from_wkt( 'LINESTRING( 0 0 0, 1 0 2, 1 1 -1 )' ) ) → -1 z_min( geom_from_wkt( 'POINT ( 0 0 )' ) ) → NULL

13.2.14. ပုံထုတ်အပြင်အဆင် Functionများ (Layout Functions)

ဤအုပ်စုတွင် ပုံထုတ် Layout item များ၏ဂုဏ်သတ္တိများကို ကိုင်တွယ်ရန် function များ ပါဝင်ပါသည်။

13.2.14.1. item_variables

Print layout (ပုံထုတ်အပြင်အဆင်) အထဲရှိ layout item တစ်ခုမှ variable များ၏ ပုံဖော်မှု (map) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	item_variables(id)
Argument များ	id - layout item ID
ဥပမာများ	map_get( item_variables('Map 0'), 'map_scale') → လက်ရှိ print layout ထဲရှိ ‘Map 0’ item ၏ စကေး

ထပ်မံဖတ်ရှုရန်- Default variables စာရင်း

13.2.14.2. map_credits

Layout တစ်ခု သို့မဟုတ် သီးသန့် layout map item ထဲတွင် ပြသထားသော layer များအတွက် credit (သုံးစွဲမှုဆိုင်ရာရပိုင်ခွင့်) စာသားများစာရင်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_credits([id], [include_layer_names=false], [layer_name_separator=’: ‘]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	id - Map item ID ။ သတ်မှတ်မထားလျှင် layout ထဲရှိ map များအားလုံးမှ layer များကိုအသုံးပြုပါလိမ့်မည်။ include_layer_names - Credit စာသားများမတိုင်မီတွင် layer အမည်များကို ပါဝင်စေရန် True သတ်မှတ်ထားပါ layer_name_separator - include_layer_names သည် true ဖြစ်နေလျှင် layer အမည်များနှင့် credit စာသားများအကြား ထည့်သွင်းမည့် စာသား
ဥပမာများ	array_to_string( map_credits() ) → Layout ထဲရှိ map item များအားလုံးတွင် ပြသထားသော layer များအားလုံးအတွက် comma ဖြင့်ပိုင်းခြားထားသော layer credit များစာရင်း၊ ဥပမာ- ‘CC-BY-NC ၊ CC-BY-SA’ array_to_string( map_credits( 'Main Map' ) ) → ‘Main Map’ layout item ထဲတွင် ပြသထားသော layer များအတွက် comma ဖြင့်ပိုင်းခြားထားသော layer credit များစာရင်း၊ ဥပမာ- ‘CC-BY-NC ၊ CC-BY-SA’ array_to_string( map_credits( 'Main Map', include_layer_names := true, layer_name_separator := ': ' ) ) → ‘Main Map’ layout item ထဲတွင် ပြသထားသော layer များအတွက် comma ဖြင့်ပိုင်းခြားထားသော layer အမည်များနှင့်၎င်းတို့၏ credit များစာရင်း၊ ဥပမာ- ‘Railway lines: CC-BY-NC ၊ Basemap: CC-BY-SA’

ဤ function တွင် layer များ၏ Access metadata properties ကို ဖြည့်ထားရန် လိုအပ်ပါသည်။

13.2.15. မြေပုံအလွှာများ (Map Layers)

ဤအုပ်စုတွင် လက်ရှိ project ထဲရှိ အသုံးပြုနိုင်သော layer များ၏ စာရင်းတစ်ခုနှင့်၊ layer တစ်ခုချင်းစီအတွက် ၎င်းတို့၏ field များ (dataset ထဲတွင်သိမ်းဆည်းထားသောအရာများ၊ virtual သို့မဟုတ် auxiliary များအပြင် ချိတ်ဆက်ထားမှုများမှအရာများ) ပါဝင်ပါသည်။ Active layer နှင့် မသက်ဆိုင်သော ရည်ညွှန်း field တစ်ခုအစား click နှစ်ချက်နှိပ်၍ string (single quoted) တစ်ခုအဖြစ် expression တွင် အမည်ထည့်သွင်းခြင်းမှလွဲ၍ field များသည် Field များနှင့်တန်ဖိုးများ (Fields and Values) တွင် ဖော်ပြထားသည့်အတိုင်း တူညီသည့်နည်လမ်းဖြင့် အပြန်အလှန်လုပ်ဆောင်ပါသည်။ အဆိုပါအချက်သည် aggregates (စုစည်းခြင်းများ) ၊ attribute (အချက်အလက်) သို့မဟုတ် spatial queries များ ဆောင်ရွက်ခြင်းကဲ့သို့သော မတူညီသည့် layer များကို ရည်ညွှန်းသော expression များ ရေးသားရန် အဆင်ပြေသည့်နည်းလမ်းတစ်ခု ဖြစ်ပါသည်။

၎င်းသည် layer များကို ကိုင်တွယ်ရန် အဆင်ပြေစေသည့် function များကိုလည်း ထောက်ပံ့ပေးပါသည်။

13.2.15.1. decode_uri

Layer တစ်ခုကိုယူ၍ လက်ရှိ data ပံ့ပိုးပေးသူ၏ uri (Uniform Resource Identifier) ကို decode (လျှို့ဝှက်သင်္ကေတကို အဓိပ္ပါယ်ဖော်) လုပ်ပေးပါသည်။ ၎င်းသည် မည်သည့် data များရရှိနိုင်မည်ဆိုသည်မှာ data ပံ့ပိုးသူပေါ်တွင် မူတည်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	decode_uri(layer, [part]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	layer - uri ကို decode ပြုလုပ်သင့်သော layer part - ပြန်ထုတ်ပေးမည့် uri ၏ အစိတ်အပိုင်း။ သတ်မှတ်မထားလျှင် uri အစိတ်အပိုင်းများအားလုံးပါဝင်သော map တစ်ခုကို ပြန်ထုတ်ပေးပါလိမ့်မည်။
ဥပမာများ	decode_uri(@layer) → {‘layerId’: ‘0’, ‘layerName’: ‘’, ‘path’: ‘/home/qgis/shapefile.shp’} decode_uri(@layer) → {‘layerId’: NULL, ‘layerName’: ‘layer’, ‘path’: ‘/home/qgis/geopackage.gpkg’} decode_uri(@layer, 'path') → ‘C:\my_data\qgis\shape.shp’

13.2.15.2. layer_property

ကိုက်ညီမှုရှိသော layer ဂုဏ်သတ္တိတစ်ခု သို့မဟုတ် metadata တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	layer_property(layer, property)
Argument များ	layer - Layer အမည် သို့မဟုတ် layer ID တစ်ခုကို ကိုယ်စားပြုသော string တစ်ခု property - ပြန်ထုတ်ပေးမည့် ဂုဏ်သတ္တိ (property) နှင့်သက်ဆိုင်သော string တစ်ခု။ ဆီလျော်မှုရှိသော ရွေးချယ်စရာများမှာ- name: layer အမည် id: layer ID title: metadata title string abstract: metadata အကျဉ်းချုပ်စာသား keywords: metadata keywords data_url: metadata URL attribution: metadata attribution string attribution_url: metadata attribution URL source: layer ရင်းမြစ် min_scale: layer အတွက် အနည်းဆုံး ပြသမှု စကေး max_scale: layer အတွက် အများဆုံး ပြသမှု စကေး is_editable: layer သည် တည်းဖြတ်ပြင်ဆင်ခြင်း mode တွင် ရှိနေလျှင် crs: layer CRS crs_definition: layer CRS ၏ အဓိပ္ပါယ်ဖွင့်ဆိုချက်အပြည့်အစုံ crs_description: layer CRS ရှင်းလင်းဖော်ပြချက် extent: layer extent (geometry object တစ်ခုအနေဖြင့်) distance_units: layer အကွာအဝေးယူနစ်များ type: layer အမျိုးအစား၊ ဥပမာ- Vector သို့မဟုတ် Raster storage_type: သိမ်းဆည်းမှု format (vector layer များသာ) geometry_type: ဂျီဩမေတြီအမျိုးအစား၊ ဥပမာ- Point (vector layer များသာ) feature_count: layer အတွက် ခန့်မှန်း feature အရေအတွက် (vector layer များသာ) path: layer data ရင်းမြစ်သို့ ဖိုင်လမ်းကြောင်း၊ file အခြေပြုသော layer များအတွက်သာ အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	layer_property('streets','title') → ‘Basemap Streets’ layer_property('airports','feature_count') → 120 layer_property('landsat','crs') → ‘EPSG:4326’

ထပ်မံဖတ်ရှုရန်- vector ၊ raster နှင့် mesh layer ဂုဏ်သတ္တိများ

13.2.15.3. load_layer

ရင်းမြစ် URI နှင့် ပံ့ပိုးသူအမည် ဖြင့် layer တစ်ခုကို ခေါ်ယူထည့်သွင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	load_layer(uri, provider)
Argument များ	uri - layer ရင်းမြစ် URI string provider - layer data ပံ့ပိုးသူအမည်
ဥပမာများ	layer_property(load_layer('c:/data/roads.shp', 'ogr'), 'feature_count') → c:/data/roads.shp vector layer မှ feature များအရေအတွက်

13.2.16. မြေပုံ Function များ (Maps Functions)

ဤအုပ်စုတွင် မြေပုံ data တည်ဆောက်ပုံများ (dictionary object များ၊ Key-value အစုံများ၊ သို့မဟုတ် ဆက်စပ် array များ အဖြစ်လည်းသိရှိကြပါသည်) ၏ ကီး (key) နှင့် တန်ဖိုး (value) များကို ဖန်တီးရန် သို့မဟုတ် ကိုင်တွယ်ရန် function များ ပါဝင်ပါသည်။ တန်ဖိုးများ၏ order (အစဉ်) သည်အရေးကြီးသည့် list data structure နှင့်မတူညီသည့်အချက်မှာ မြေပုံ object ထဲရှိ key-value အစုံများ၏ order သည် ဆက်စပ်ပတ်သက်မှုမရှိပဲ တန်ဖိုးများကို ၎င်းတို့၏ key များဖြင့် သတ်မှတ်ထားပါသည်။

13.2.16.1. from_json

JSON formatted string (JSON ဖြင့်ရေးသားထားသည့် စာသား) တစ်ခုကို ထည့်သွင်းသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	from_json(string)
Argument များ	string - JSON string
ဥပမာများ	from_json('{"qgis":"rocks"}') → { ‘qgis’: ‘rocks’ } from_json('[1,2,3]') → [1,2,3]

13.2.16.2. hstore_to_map

hstore-formatted string (hstore ဖြင့်ရေးသားထားသည့် string) တစ်ခုမှ map (ဖော်ပြချက်) တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	hstore_to_map(string)
Argument များ	string - ထည့်သွင်းအသုံးပြုသော string
ဥပမာများ	hstore_to_map('qgis=>rocks') → { ‘qgis’: ‘rocks’ }

13.2.16.3. map

Parameter အတွဲများ (သတ်မှတ်ချက်များ) အဖြစ် ကျော်ဖြတ်သည့် key များနှင့် တန်ဖိုးများအားလုံးပါဝင်သော map (ဖော်ပြချက်) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map(key1, value1, key2, value2, …)
Argument များ	key - key (string) တစ်ခု value - တန်ဖိုး (value) တစ်ခု
ဥပမာများ	map('1','one','2', 'two') → { ‘1’: ‘one’, ‘2’: ‘two’ } map('1','one','2', 'two')['1'] → ‘one’

13.2.16.4. map_akeys

Map တစ်ခု၏ key များအားလုံးကို array တစ်ခုအဖြစ် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_akeys(map)
Argument များ	map - map တစ်ခု
ဥပမာများ	map_akeys(map('1','one','2','two')) → [ ‘1’, ‘2’ ]

13.2.16.5. map_avals

Map တစ်ခု၏ တန်ဖိုးများအားလုံးကို array တစ်ခုအဖြစ် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_avals(map)
Argument များ	map - map တစ်ခု
ဥပမာများ	map_avals(map('1','one','2','two')) → [ ‘one’, ‘two’ ]

13.2.16.6. map_concat

ပေးထားသည့် map များ၏ entries (ထည့်သွင်းသောအချက်အလက်များ) များပါဝင်သော map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ map နှစ်ခုသည် တူညီသည့် key ပါဝင်နေပါက ဒုတိယ map ၏ တန်ဖိုးကို ယူမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_concat(map1, map2, …)
Argument များ	map - map တစ်ခု
ဥပမာများ	map_concat(map('1','one', '2','overridden'),map('2','two', '3','three')) → { ‘1’: ‘one’, ‘2’: ‘two’, ‘3’: ‘three’ }

13.2.16.7. map_delete

ပေးထားသည့် key နှင့် ၎င်း၏သက်ဆိုင်ရာတန်ဖိုးကို ဖျက်ထားသည့် map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_delete(map, key)
Argument များ	map - map တစ်ခု key - ဖျက်ပစ်မည့် key
ဥပမာများ	map_delete(map('1','one','2','two'),'2') → { ‘1’: ‘one’ }

13.2.16.8. map_exist

အကယ်၍ ပေးထားသည့် key သည် map ထဲတွင် ရှိပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_exist(map, key)
Argument များ	map - map တစ်ခု key - ရှာဖွေရန် (lookup) key
ဥပမာများ	map_exist(map('1','one','2','two'),'3') → FALSE

13.2.16.9. map_get

Map တစ်ခု၏ key ၌ရှိသော ၎င်း၏တန်ဖိုး ကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ key မရှိပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_get(map, key)
Argument များ	map - map တစ်ခု key - ရှာဖွေရန် (lookup) key
ဥပမာများ	map_get(map('1','one','2','two'),'2') → ‘two’ map_get( item_variables('Map 0'), 'map_scale') → လက်ရှိ ပုံထုတ်အပြင်အဆင် (print layout) ထဲရှိ ‘Map 0’ (အကယ်၍ ၎င်းရှိပါက) item ၏ စကေး

Hint

Map တစ်ခုမှ တန်ဖိုးတစ်ခုကို ရရှိနိုင်ရန် index operator ([]) ကိုလည်း အသုံးပြုနိုင်ပါသည်။

13.2.16.10. map_insert

ထပ်မံပေါင်းထည့်ထားသည့် key/value တစ်ခုပါရှိသည့် map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ key ရှိနေပြီးသားဖြစ်ပါက ၎င်း၏တန်ဖိုးကို အစားထိုးရေးသား (overridden) မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_insert(map, key, value)
Argument များ	map - map တစ်ခု key - ပေါင်းထည့်ရန် key value - ပေါင်းထည့်ရန် တန်ဖိုး
ဥပမာများ	map_insert(map('1','one'),'3','three') → { ‘1’: ‘one’, ‘3’: ‘three’ } map_insert(map('1','one','2','overridden'),'2','two') → { ‘1’: ‘one’, ‘2’: ‘two’ }

13.2.16.11. map_prefix_keys

ပေးထားသည့် string တစ်ခုဖြင့် ရှေ့တွင်ဆက်ထားသော (prefixed) key များအားလုံးပါရှိသည့် map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_prefix_keys(map, prefix)
Argument များ	map - map တစ်ခု prefix - string တစ်ခု
ဥပမာများ	map_prefix_keys(map('1','one','2','two'), 'prefix-') → { ‘prefix-1’: ‘one’, ‘prefix-2’: ‘two’ }

13.2.16.12. map_to_hstore

Map element များကို hstore-formatted string (hstore ဖြင့်ရေးသားထားသည့် string) တစ်ခု အဖြစ်သို့ ပေါင်းစပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_to_hstore(map)
Argument များ	map - ထည့်သွင်းအသုံးပြုသော မြေပုံ
ဥပမာများ	map_to_hstore(map('qgis','rocks')) → ‘“qgis”=>”rocks”’

13.2.16.13. map_to_html_dl

Map element များကို HTML definition list string တစ်ခုအဖြစ်သို့ ပေါင်းစပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_to_html_dl(map)
Argument များ	map - ထည့်သွင်းအသုံးပြုသော မြေပုံ
ဥပမာများ	map_to_html_dl(map('qgis','rocks')) → <dl><dt>qgis</dt><dd>rocks</dd></dl>

13.2.16.14. map_to_html_table

Map element များကို HTML table string တစ်ခုအဖြစ်သို့ ပေါင်းစပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	map_to_html_table(map)
Argument များ	map - ထည့်သွင်းအသုံးပြုသော မြေပုံ
ဥပမာများ	map_to_html_table(map('qgis','rocks')) → <table><thead><th>qgis</th></thead><tbody><tr><td>rocks</td></tr></tbody></table>

13.2.16.15. to_json

Map ၊ array သို့မဟုတ် အခြားတန်ဖိုးတစ်ခုမှ JSON formatted string (JSON ဖြင့်ရေးသားထားသည့် string) တစ်ခုကို ဖန်တီးပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_json(value)
Argument များ	value - ထည့်သွင်းအသုံးပြုသော တန်ဖိုး
ဥပမာများ	to_json(map('qgis','rocks')) → {“qgis”:”rocks”} to_json(array(1,2,3)) → [1,2,3]

13.2.16.16. url_encode

Map တစ်ခုမှ URL encoded string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ Character များအားလုံးကို ၎င်းတို့၏ သင့်တော်သလို encode ပြုလုပ်ထားသည့်ပုံစံ (properly-encoded form) ဖြင့် ပြောင်းလဲမှုပြုလုပ်ပြီး fully-compliant (အပြည့်အဝလိုက်နာမှုရှိသော) query string တစ်ခုကို ထုတ်ပေးပါသည်။

အပေါင်းလက္ခဏာ ‘+’ ကို ပြောင်းလဲမည်မဟုတ်သည်ကို သတိပြုရမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	url_encode(map)
Argument များ	map - map တစ်ခု
ဥပမာများ	url_encode(map('a&+b', 'a and plus b', 'a=b', 'a equals b')) → ‘a%26+b=a%20and%20plus%20b&a%3Db=a%20equals%20b’

13.2.17. သင်္ချာ Function များ (Mathematical Functions)

ဤအုပ်စုတွင် သင်္ချာဆိုင်ရာ function များ ပါဝင်ပါသည်။ (ဥပမာ- square root၊ sin နှင့် cos)

13.2.17.1. abs

ကိန်းဂဏန်းတစ်ခု၏ ပကတိတန်ဖိုး (absolute value) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	abs(value)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	abs(-2) → 2

13.2.17.2. acos

Radian (ထောင့်တိုင်းတာသည့် ယူနစ်တစ်မျိုး) များဖြင့် တန်ဖိုး (value) တစ်ခု၏ inverse cosine (inverse cosine မှာ cos-1 ကိုဆိုလိုပါသည်) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	acos(value)
Argument များ	value - radian များဖြင့် ထောင့်တစ်ခု၏ cosine
ဥပမာများ	acos(0.5) → 1.0471975511966

13.2.17.3. asin

Radian (ထောင့်တိုင်းတာသည့် ယူနစ်တစ်မျိုး) များဖြင့် တန်ဖိုးတစ်ခု၏ inverse sine (inverse sine မှာ Sin-1 ကိုဆိုလိုပါသည်) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	asin(value)
Argument များ	value - radian များဖြင့် ထောင့်တစ်ခု၏ sine
ဥပမာများ	asin(1.0) → 1.5707963267949

13.2.17.4. atan

Radian (ထောင့်တိုင်းတာသည့် ယူနစ်တစ်မျိုး) များဖြင့် တန်ဖိုးတစ်ခု၏ inverse tangent(inverse tangent tan-1 ကိုဆိုလိုပါသည်) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	atan(value)
Argument များ	value - radian များဖြင့် ထောင့်တစ်ခု၏ tan
ဥပမာများ	atan(0.5) → 0.463647609000806

13.2.17.5. atan2

ရလာဒ် (result) ၏ quadrant (စက်ဝိုင်း၏လေးပုံတစ်ပုံ) ကို ဆုံးဖြတ်ရန် argument နှစ်ခု၏ sign(သင်္ကေတ) များကို အသုံးပြုခြင်းအားဖြင့် dy/dx (differentiate ကို ကိုယ်စားပြုသည့် သင်္ကေတ) ၏ inverse tangent ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	atan2(dy, dx)
Argument များ	dy - y ကိုဩဒိနိတ် ခြားနားချက် dx - x ကိုဩဒိနိတ် ခြားနားချက်
ဥပမာများ	atan2(1.0, 1.732) → 0.523611477769969

13.2.17.6. ceil

ကိန်းဂဏန်းတစ်ခုကို တိုး၍ အနီးစပ်ဆုံးယူခြင်း (Round) ပြုလုပ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	ceil(value)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	ceil(4.9) → 5 ceil(-4.9) → -4

13.2.17.7. clamp

Input တန်ဖိုးတစ်ခုကို သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏ (range) တွင် ကန့်သတ်ခြင်းပြုလုပ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	clamp(minimum, input, maximum)
Argument များ	minimum - input အား ယူရန်ခွင့်ပြုထားသည့် အငယ်ဆုံးတန်ဖိုး input - minimum (အနည်းဆုံး) နှင့် maximum (အများဆုံး) ဖြင့် သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏသို့ ကန့်သတ်ခံရမည့် တန်ဖိုးတစ်ခု maximum - input အား ယူရန်ခွင့်ပြုထားသည့် အကြီးဆုံးတန်ဖိုး
ဥပမာများ	clamp(1,5,10) → 5 input သည် 1 နှင့် 10 ကြားဖြစ်သောကြောင့် ပြောင်းလဲခြင်းမရှိဘဲ ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ clamp(1,0,10) → 1 input သည် အနည်းဆုံးတန်ဖိုး 1 အောက်ငယ်သောကြောင့် function သည် 1 ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။ clamp(1,11,10) → 10 input သည် အများဆုံးတန်ဖိုး 10 ထက်ကြီးသောကြောင့် function သည် 10 ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

13.2.17.8. cos

ထောင့်တစ်ခု၏ cosine ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	cos(angle)
Argument များ	angle - radian များဖြင့် ထောင့်
ဥပမာများ	cos(1.571) → 0.000796326710733263

13.2.17.9. degrees

Radian များမှ ဒီဂရီ (degrees) များသို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	degrees(radians)
Argument များ	radians - ကိန်းဂဏန်းတန်ဖိုး
ဥပမာများ	degrees(3.14159) → 180 degrees(1) → 57.2958

13.2.17.10. exp

တန်ဖိုးတစ်ခု၏ exponential (ထပ်ကိန်း) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	exp(value)
Argument များ	value - exponent (ထပ်ကိန်း) ကို ပြန်ထုတ်ပေးမည့်ဂဏန်း
ဥပမာများ	exp(1.0) → 2.71828182845905

13.2.17.11. floor

ကိန်းဂဏန်းတစ်ခုကို လျှော့၍ အနီးစပ်ဆုံးယူခြင်း (Round) ပြုလုပ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	floor(value)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	floor(4.9) → 4 floor(-4.9) → -5

13.2.17.12. ln

တန်ဖိုးတစ်ခု၏ natural logarithm (လော့ဂရမ်သမ်) ကို ပြန်ထုတ်ပေးပါသည်။ (ကိန်းတစ်ခု၏ natural logarithm ဆိုသည်မှာ log ၏ base သည် ကိန်းသေ e ဖြစ်နေသည့် log အမျိုးအစားဖြစ်ပါသည်)

Syntax (ဝါကျဖွဲ့ပုံ)	ln(value)
Argument များ	value - ကိန်းဂဏန်း တန်ဖိုး
ဥပမာများ	ln(1) → 0 ln(2.7182818284590452354) → 1

13.2.17.13. log

ထည့်သွင်းသော တန်ဖိုး နှင့် base (အခြေ) ၏ logarithm တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	log(base, value)
Argument များ	base - မည်သည့်အပေါင်းကိန်းမဆို value - မည်သည့်အပေါင်းကိန်းမဆို
ဥပမာများ	log(2, 32) → 5 log(0.5, 32) → -5

13.2.17.14. log10

ထည့်သွင်းသော expression ၏ base 10 ရှိသော logarithm တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	log10(value)
Argument များ	value - မည်သည့်အပေါင်းကိန်းမဆို
ဥပမာများ	log10(1) → 0 log10(100) → 2

13.2.17.15. max

တန်ဖိုးများပါရှိသည့် အစုတစ်ခုထဲရှိ အကြီးဆုံးတန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	max(value1, value2, …)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	max(2,10.2,5.5) → 10.2 max(20.5,NULL,6.2) → 20.5

13.2.17.16. min

တန်ဖိုးများပါရှိသည့် အစုတစ်ခုထဲရှိ အသေးဆုံး တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	min(value1, value2, …)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	min(20.5,10,6.2) → 6.2 min(2,-10.3,NULL) → -10.3

13.2.17.17. pi

တွက်ချက်မှုများအတွက် ပိုင် (pi) တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	pi()
ဥပမာများ	pi() → 3.14159265358979

13.2.17.18. radians

ဒီဂရီများမှ radian များသို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	radians(degrees)
Argument များ	degrees - ကိန်းဂဏန်းတန်ဖိုး
ဥပမာများ	radians(180) → 3.14159 radians(57.2958) → 1

13.2.17.19. rand

အနည်းဆုံး (minimum) နှင့် အများဆုံး (maximum) argument (၎င်းတို့အပါအဝင်) ဖြင့် သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏ အတွင်းတွင် ကျပန်း ကိန်းပြည့်တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ seed တစ်ခုကို ပံ့ပိုးပေးထားပါက ပြန်ထုတ်ပေးမည့်အရာသည် seed အပေါ်တွင် မူတည်ပြီး အမြဲတူညီမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	rand(min, max, [seed=NULL]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	min - အလိုရှိသည့် ဖြစ်နိုင်ခြေရှိသော အသေးဆုံး ကျပန်းဂဏန်းတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် ကိန်းပြည့် (integer) တစ်ခု max - အလိုရှိသည့် ဖြစ်နိုင်ခြေရှိသော အကြီးဆုံး ကျပန်းဂဏန်းတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် ကိန်းပြည့် (integer) တစ်ခု seed - seed အဖြစ်အသုံးပြုရန် မည်သည့်တန်ဖိုးမဆို
ဥပမာများ	rand(1, 10) → 8

13.2.17.20. randf

အနည်းဆုံး (minimum) နှင့် အများဆုံး (maximum) argument (၎င်းတို့အပါအဝင်) ဖြင့် သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏ (range) အတွင်းတွင် ကျပန်း float (ဒဿမကိန်းများပါဝင်သည့် အပေါင်း သို့မဟုတ် အနုတ် အပြည့်ကိန်း) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ seed တစ်ခုကို ပံ့ပိုးပေးထားပါက ပြန်ထုတ်ပေးမည့်အရာသည် seed အပေါ်တွင် မူတည်ပြီး အမြဲတူညီမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	randf([min=0.0], [max=1.0], [seed=NULL]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	min - အလိုရှိသည့် ဖြစ်နိုင်ခြေရှိသော အသေးဆုံး ကျပန်းဂဏန်းတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် float တစ်ခု max - အလိုရှိသည့် ဖြစ်နိုင်ခြေရှိသော အကြီးဆုံး ကျပန်းဂဏန်းတစ်ခုကို ကိုယ်စားပြုဖော်ပြသည့် float တစ်ခု seed - seed အဖြစ်အသုံးပြုရန် မည်သည့်တန်ဖိုးမဆို
ဥပမာများ	randf(1, 10) → 4.59258286403147

13.2.17.21. round

ကိန်းဂဏန်းတစ်ခုကို ဒဿမနေရာအရေအတွက်များသို့ အနီးစပ်ဆုံးယူခြင်း (round) ပြုလုပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	round(value, [places=0]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	value - round ပြုလုပ်မည့် ဒဿမကိန်း places - ဒဿမများကို round ပြုလုပ်ရန် နေရာအရေအတွက်များကို ကိုယ်စားပြုဖော်ပြသည့် စိတ်ကြိုက် ကိန်းပြည့် (integer)။ အနုတ်လည်း ဖြစ်နိုင်ပါသည်။
ဥပမာများ	round(1234.567, 2) → 1234.57 round(1234.567) → 1235 round(1234.567, -1) → 1230

13.2.17.22. scale_exponential

Exponential curve တစ်ခုကို အသုံးပြုပြီး input domain တစ်ခုမှ ပေးထားသည့် တန်ဖိုးတစ်ခုကို output range (အပိုင်းအခြားပမာဏ) တစ်ခုသို့ အသွင်ပြောင်းပေးပါသည်။ ဤလုပ်ဆောင်ချက်ကို သတ်မှတ်ထားသည့် output range အတွင်း တန်ဖိုးများ အဝင် သို့မဟုတ် အထွက်များ ချောမွေ့လွယ်ကူစေရေးအတွက် အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	scale_exponential(value, domain_min, domain_max, range_min, range_max, exponent)
Argument များ	value - input domain ထဲရှိ တန်ဖိုးတစ်ခု။ Function သည် သက်ဆိုင်ရာ ချိန်ညှိထားသည့် တန်ဖိုးတစ်ခုကို output range ထဲတွင် ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ domain_min - input domain ထဲရှိ အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အသေးဆုံးတန်ဖိုး။ domain_max - input domain ထဲရှိ အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အကြီးဆုံးတန်ဖိုး။ range_min - output range ထဲတွင် အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အသေးဆုံးတန်ဖိုး။ range_max - output range ထဲတွင် အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အကြီးဆုံးတန်ဖိုး။ exponent - အပေါင်းကိန်းတန်ဖိုးတစ်ခု (0 ထက်ကြီးသော)၊ ၎င်းသည် input တန်ဖိုးများအား output range တွင် မည်သို့ ပုံဖော်မည်ဆိုသည့် နည်းလမ်းကို ဆုံးဖြတ်ပေးပါသည်။ ကြီးမားသည့် ထပ်ကိန်းများ (exponents) သည် input တန်ဖိုးများအနေဖြင့် domain maximum ကို ချဉ်းကပ်လာသည့်အခါ၌ အရှိန်မမြှင့်မီတွင် ဖြည်းဖြည်းချင်းစတင်ခြင်းဖြင့် output တန်ဖိုးများကို ‘ease in’ ဖြစ်စေပါသည်။ သေးငယ်သည့် ထပ်ကိန်းများ (1 အောက်ငယ်သော) သည် output တန်ဖိုးများကို ‘ease out’ ဖြစ်စေပါသည်။ ၎င်းတွင် mapping (ပုံဖော်ခြင်း) သည် မြန်ဆန်စွာစတင်သော်လည်း ၎င်းသည် domain maximum ကို ချဉ်းကပ်လာသည့်အခါတွင် နှေးသွားပါသည်။
ဥပမာများ	scale_exp(5,0,10,0,100,2) → 25 easing in၊ 2 ရှိသည့် ထပ်ကိန်း (exponent) တစ်ခုကို အသုံးပြုပြီး scale_exp(3,0,10,0,100,0.5) → 54.772 easing out၊ 0.5 ရှိသည့် ထပ်ကိန်း (exponent) တစ်ခုကို အသုံးပြုပြီး

13.2.17.23. scale_linear

Linear interpolation ကို အသုံးပြုပြီး input domain တစ်ခုမှ ပေးထားသည့် တန်ဖိုးတစ်ခုကို output range သို့ အသွင်ပြောင်းပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	scale_linear(value, domain_min, domain_max, range_min, range_max)
Argument များ	value - input domain ထဲရှိ တန်ဖိုးတစ်ခု။ Function သည် သက်ဆိုင်ရာ ချိန်ညှိထားသည့် တန်ဖိုးတစ်ခုကို output range တွင် ပြန်ထုတ်ပေးပါသည်။ domain_min - input domain ထဲရှိ အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အသေးဆုံးတန်ဖိုး။ domain_max - input domain ထဲရှိ အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အကြီးဆုံးတန်ဖိုး။ range_min - output range ထဲတွင် အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အသေးဆုံးတန်ဖိုး။ range_max - output range ထဲတွင် အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အကြီးဆုံးတန်ဖိုး။
ဥပမာများ	scale_linear(5,0,10,0,100) → 50 scale_linear(0.2,0,1,0,360) → 72 0 နှင့် 1 အကြားရှိ တန်ဖိုးတစ်ခုကို 0 နှင့် 360 အကြားရှိ ထောင့်တစ်ခုသို့ ချိန်ညှိခြင်း scale_linear(1500,1000,10000,9,20) → 9.6111111 1000 နှင့် 10000 အကြားပြောင်းလဲနေသည့် population (လူဦးရေ) တစ်ခုကို စာလုံးအရွယ်အစား 9 နှင့် 20 အကြားသို့ ချိန်ညှိခြင်း

13.2.17.24. scale_polynomial

Polynomial curve တစ်ခုကို အသုံးပြုပြီး input domain တစ်ခုမှ ပေးထားသည့် တန်ဖိုးတစ်ခုကို output range (အပိုင်းအခြားပမာဏ) တစ်ခုသို့ အသွင်ပြောင်းပေးပါသည်။ ဤလုပ်ဆောင်ချက်ကို သတ်မှတ်ထားသည့် output range အတွင်း တန်ဖိုးများ အဝင် သို့မဟုတ် အထွက်များ ချောမွေ့လွယ်ကူစေရေးအတွက် အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	scale_polynomial(value, domain_min, domain_max, range_min, range_max, exponent)
Argument များ	value - input domain ထဲရှိ တန်ဖိုးတစ်ခု။ Function သည် သက်ဆိုင်ရာ ချိန်ညှိထားသည့် တန်ဖိုးတစ်ခုကို output range ထဲတွင် ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ domain_min - input domain ထဲရှိ အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အသေးဆုံးတန်ဖိုး။ domain_max - input domain ထဲရှိ အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Input တန်ဖိုးမှ ယူသင့်သည့် အကြီးဆုံးတန်ဖိုး။ range_min - output range ထဲတွင် အနိမ့်ဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အသေးဆုံးတန်ဖိုး။ range_max - output range ထဲတွင် အများဆုံးတန်ဖိုးကို သတ်မှတ်သည်။ Function ကြောင့် output ဖြစ်သင့်သည့် အကြီးဆုံးတန်ဖိုး။ exponent - အပေါင်းကိန်းတန်ဖိုးတစ်ခု (0 ထက်ကြီးသော)၊ ၎င်းသည် input တန်ဖိုးများအား output range တွင် မည်သို့ ပုံဖော်မည်ဆိုသည့် နည်းလမ်းကို ဆုံးဖြတ်ပေးပါသည်။ ကြီးမားသည့် ထပ်ကိန်းများ (exponents) သည် input တန်ဖိုးများအနေဖြင့် domain maximum ကို ချဉ်းကပ်လာသည့်အခါ၌ အရှိန်မမြှင့်မီတွင် ဖြည်းဖြည်းချင်းစတင်ခြင်းဖြင့် output တန်ဖိုးများကို ‘ease in’ ဖြစ်စေပါသည်။ သေးငယ်သည့် ထပ်ကိန်းများ (1 အောက်ငယ်သော) သည် output တန်ဖိုးများကို ‘ease out’ ဖြစ်စေပါသည်။ ၎င်းတွင် mapping (ပုံဖော်ခြင်း) သည် မြန်ဆန်စွာစတင်သော်လည်း ၎င်းသည် domain maximum ကို ချဉ်းကပ်လာသည့်အခါတွင် နှေးသွားပါသည်။
ဥပမာများ	scale_polynomial(5,0,10,0,100,2) → 25 easing in၊ 2 ရှိသည့် ထပ်ကိန်း (exponent) တစ်ခုကို အသုံးပြုပြီး scale_polynomial(3,0,10,0,100,0.5) → 54.772 easing out၊ 0.5 ရှိသည့် ထပ်ကိန်း (exponent) တစ်ခုကို အသုံးပြုပြီး

13.2.17.25. sin

ထောင့်တစ်ခု၏ sine ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sin(angle)
Argument များ	angle - radian များဖြင့် ထောင့်
ဥပမာများ	sin(1.571) → 0.999999682931835

13.2.17.26. sqrt

တန်ဖိုးတစ်ခု၏ နှစ်ထပ်ကိန်းရင်း (square root) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sqrt(value)
Argument များ	value - ကိန်းဂဏန်းတစ်ခု
ဥပမာများ	sqrt(9) → 3

13.2.17.27. tan

ထောင့်တစ်ခု၏ tangent ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	tan(angle)
Argument များ	angle - radian များဖြင့် ထောင့်
ဥပမာများ	tan(1.0) → 1.5574077246549

13.2.18. Mesh function များ (Meshes Functions)

ဤအုပ်စုတွင် mesh (အချိန်ဆိုင်ရာနှင့်အခြားအစိတ်အပိုင်းများပါဝင်သည့် ဖွဲ့စည်းပုံမရှိသောအကွက်) နှင့်ဆက်စပ်သည့် တန်ဖိုးများကို တွက်ချက်ခြင်း သို့မဟုတ် ထုတ်ပေးခြင်းဆိုင်ရာ function များ ပါဝင်ပါသည်။

13.2.18.1. $face_area

လက်ရှိ mesh မျက်နှာပြင်၏ ဧရိယာကို ပြန်ထုတ်ပေးပါသည်။ ဤ function ဖြင့် တွက်ချက်ထားသော ဧရိယာသည် လက်ရှိ project ၏ ellipsoid setting နှင့် ဧရိယာယူနစ် setting များ နှစ်မျိုးစလုံးနှင့် ပတ်သက်ဆက်စပ်ပါသည်။ ဥပမာအားဖြင့်- project အတွက် ellipsoid တစ်ခုကို သတ်မှတ်ပေးထားလျှင် တွက်ချက်ထားသော ဧရိယာသည် ellipsoidal ဖြစ်ပါလိမ့်မည်၊ ellipsoid ကို သတ်မှတ်မထားပါက တွက်ချက်ထားသော ဧရိယာသည် planimetric ဖြစ်ပါလိမ့်မည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$face_area
ဥပမာများ	$face_area → 42

13.2.18.2. $face_index

လက်ရှိ mesh မျက်နှာပြင်၏ index (အညွှန်းကိန်း) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$face_index
ဥပမာများ	$face_index → 4581

13.2.18.3. $vertex_as_point

လက်ရှိ vertex (မျဉ်းအဆစ်) အား point ဂျီဩမေတြီတစ်ခုအနေဖြင့် ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$vertex_as_point
ဥပမာများ	geom_to_wkt( $vertex_as_point ) → ‘POINT(800 1500 41)’

13.2.18.4. $vertex_index

လက်ရှိ mesh vertex ၏ index (အညွှန်းကိန်း) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$vertex_index
ဥပမာများ	$vertex_index → 9874

13.2.18.5. $vertex_x

လက်ရှိ mesh vertex ၏ X ကိုဩဒိနိတ် ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$vertex_x
ဥပမာများ	$vertex_x → 42.12

13.2.18.6. $vertex_y

လက်ရှိ mesh vertex ၏ Y ကိုဩဒိနိတ် ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$vertex_y
ဥပမာများ	$vertex_y → 12.24

13.2.18.7. $vertex_z

လက်ရှိ mesh vertex ၏ Z တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$vertex_z
ဥပမာများ	$vertex_z → 42

13.2.19. Operator များ ((+) ၊(-) ၊(/) ၊(*))

ဤအုပ်စုတွင် operator များ ပါဝင်ပါသည် (ဥပမာ- + ၊ - ၊ *)။ အောက်ဖော်ပြပါ သင်္ချာဆိုင်ရာ function အများစုအတွက် မှတ်သားထားရန်မှာ Input (ထည့်သွင်းခြင်း) တစ်ခုသည် NULL ဖြစ်လျှင် ထွက်ပေါ်လာမည့် ရလာဒ်သည် NULL ဖြစ်မည် ဖြစ်ပါသည်။

13.2.19.1. %

စားခြင်း (division) တစ်ခု၏ အကြွင်း (Remainder)။ တည်ကိန်း (dividend) ၏ လက္ခဏာသင်္ကေတ (sign) ကို ယူပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a % b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	9 % 2 → 1 9 % -2 → 1 -9 % 2 → -1 5 % NULL → NULL

13.2.19.2. *

တန်ဖိုးနှစ်ခု၏ မြှောက်ခြင်း (multiplication)

Syntax (ဝါကျဖွဲ့ပုံ)	a * b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 * 4 → 20 5 * NULL → NULL

13.2.19.3. +

တန်ဖိုးနှစ်ခု၏ပေါင်းခြင်း။ အကယ်၍ တန်ဖိုးတစ်ခုသည် NULL ဖြစ်ပါက ရရှိလာမည့် ရလဒ်သည် NULL ဖြစ်လိမ့်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a + b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 + 4 → 9 5 + NULL → NULL 'QGIS ' + 'ROCKS' → ‘QGIS ROCKS’ to_datetime('2020-08-01 12:00:00') + '1 day 2 hours' → 2020-08-02T14:00:00

ထပ်မံဖတ်ရှုရန်- concat ၊ ||

13.2.19.4. -

တန်ဖိုးနှစ်ခု၏ခြားနားခြင်း။ အကယ်၍ တန်ဖိုးတစ်ခုသည် NULL ဖြစ်ပါက ရရှိလာမည့် ရလဒ်သည် NULL ဖြစ်လိမ့်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a - b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 - 4 → 1 5 - NULL → NULL to_datetime('2012-05-05 12:00:00') - to_interval('1 day 2 hours') → 2012-05-04T10:00:00

13.2.19.5. /

တန်ဖိုးနှစ်ခု၏ စားခြင်း

Syntax (ဝါကျဖွဲ့ပုံ)	a / b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 / 4 → 1.25 5 / NULL → NULL

13.2.19.6. //

တန်ဖိုးနှစ်ခု၏ Floor division (Floor division ဆိုသည်မှာ စားလဒ်ကို အနီးစပ်ဆုံးယူခြင်းဖြစ်သည်။ ဥပမာ 10/4=2.5 <—-normal division 10//4=2 <—-floor division)

Syntax (ဝါကျဖွဲ့ပုံ)	a // b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	9 // 2 → 4

13.2.19.7. <

တန်ဖိုး နှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ဘယ်ဘက်တန်ဖိုး (left value) သည် ညာဘက်တန်ဖိုးအောက်ငယ်ပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a < b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 < 4 → FALSE 5 < 5 → FALSE 4 < 5 → TRUE

13.2.19.8. <=

တန်ဖိုး နှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ဘယ်ဘက်တန်ဖိုး (left value) သည် ညာဘက်တန်ဖိုးနှင့်ညီသည် သို့မဟုတ် ညာဘက်တန်ဖိုးအောက်ငယ်ပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a <= b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 <= 4 → FALSE 5 <= 5 → TRUE 4 <= 5 → TRUE

13.2.19.9. <>

တန်ဖိုးနှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ၎င်းတို့သည် ညီမျှခြင်းမရှိပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a <> b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 <> 4 → TRUE 4 <> 4 → FALSE 5 <> NULL → NULL NULL <> NULL → NULL

13.2.19.10. =

တန်ဖိုးနှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ၎င်းတို့သည် ညီမျှပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a = b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 = 4 → FALSE 4 = 4 → TRUE 5 = NULL → NULL NULL = NULL → NULL

13.2.19.11. >

တန်ဖိုး နှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ဘယ်ဘက်တန်ဖိုး (left value) သည် ညာဘက်တန်ဖိုးထက်ကြီးပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a > b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 > 4 → TRUE 5 > 5 → FALSE 4 > 5 → FALSE

13.2.19.12. >=

တန်ဖိုး နှစ်ခုကို နှိုင်းယှဉ်ပြီး အကယ်၍ ဘယ်ဘက်တန်ဖိုး (left value) သည် ညာဘက်တန်ဖိုးနှင့်ညီသည် သို့မဟုတ် ညာဘက်တန်ဖိုးထက်ကြီးပါက 1 အဖြစ် သုံးသပ်မည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a >= b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 <= 4 → FALSE 5 <= 5 → TRUE 4 <= 5 → TRUE

13.2.19.13. AND

အခြေအနေ (conditions) a နှင့် b များသည် true (မှန်ကန်မှုရှိပါက) ဖြစ်ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a AND b
Argument များ	a - condition(အခြေအနေ) b - condition(အခြေအနေ)
ဥပမာများ	TRUE AND TRUE → TRUE TRUE AND FALSE → FALSE 4 = 2+2 AND 1 = 1 → TRUE 4 = 2+2 AND 1 = 2 → FALSE

13.2.19.14. BETWEEN

အကယ်၍ တန်ဖိုးသည် သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏ (range) အတွင်းတွင်ရှိပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။ အပိုင်းအခြားပမာဏသည် အစနှင့်အဆုံးသတ် (bounds) များပါ အပါအဝင်ဖြစ်ပါသည်။ Exclusion (ပါဝင်မှုမရှိခြင်း) အတွက် စမ်းသပ်ရန် NOT BETWEEN ကို အသုံးပြုနိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	value BETWEEN lower_bound AND higher_bound
Argument များ	value - အပိုင်းအခြားပမာဏ (range) တစ်ခုနှင့် နှိုင်းယှဉ်ရန် တန်ဖိုး။ ၎င်းသည် string တစ်ခု၊ ဂဏန်းတစ်ခု သို့မဟုတ် ရက်စွဲတစ်ခု ဖြစ်နိုင်ပါသည်။ lower_bound AND higher_bound - range bounds (အပိုင်းအခြားပမာဏ နယ်နိမိတ်)
ဥပမာများ	'B' BETWEEN 'A' AND 'C' → TRUE 2 BETWEEN 1 AND 3 → TRUE 2 BETWEEN 2 AND 3 → TRUE 'B' BETWEEN 'a' AND 'c' → FALSE lower('B') BETWEEN 'a' AND 'b' → TRUE

Note

value BETWEEN lower_bound AND higher_bound သည် “value >= lower_bound AND value <= higher_bound” နှင့်အတူတူဖြစ်ပါသည်။

ထပ်မံဖတ်ရှုရန်- NOT BETWEEN

13.2.19.15. ILIKE

အကယ်၍ ပထမဆုံးသတ်မှတ်ချက် (first parameter) သည် ပံ့ပိုးထားသည့် ပုံစံ (pattern) နှင့် case-insensitive (စာလုံးအကြီးအသေးကိုဂရုမပြုပဲ) ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။ Case-sensitive (စာလုံးအကြီးအသေးကို ဂရုပြုသော) ဖြစ်စွာ ကိုက်ညီလိုပါက ILIKE အစား ကို LIKE အသုံးပြုနိုင်ပါသည်။ ကိန်းဂဏန်းများနှင့်လည်း လုပ်ဆောင်နိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	string/number ILIKE pattern
Argument များ	string/number - ရှာဖွေမှုပြုလုပ်ရန် string pattern - ရှာဖွေရန် ပုံစံ။ ‘%’ ကို wildcard တစ်ခုအဖြစ် ၊ ‘_’ ကို single char အဖြစ် နှင့် ‘\\’ ကို special character များကို ရှောင်ရှားရန် အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	'A' ILIKE 'A' → TRUE 'A' ILIKE 'a' → TRUE 'A' ILIKE 'B' → FALSE 'ABC' ILIKE 'b' → FALSE 'ABC' ILIKE 'B' → FALSE 'ABC' ILIKE '_b_' → TRUE 'ABC' ILIKE '_B_' → TRUE 'ABCD' ILIKE '_b_' → FALSE 'ABCD' ILIKE '_B_' → FALSE 'ABCD' ILIKE '_b%' → TRUE 'ABCD' ILIKE '_B%' → TRUE 'ABCD' ILIKE '%b%' → TRUE 'ABCD' ILIKE '%B%' → TRUE 'ABCD%' ILIKE 'abcd\\%' → TRUE 'ABCD' ILIKE '%B\\%' → FALSE

13.2.19.16. IN

အကယ်၍ တန်ဖိုးကို တန်ဖိုးများစာရင်းအတွင်းတွင် တွေ့ရှိပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a IN b
Argument များ	a - တန်ဖိုး b - တန်ဖိုးများစာရင်း
ဥပမာများ	'A' IN ('A','B') → TRUE 'A' IN ('C','B') → FALSE

13.2.19.17. IS

အကယ်၍ a သည် b နှင့် တူညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a IS b
Argument များ	a - မည်သည့် တန်ဖိုးမဆို b - မည်သည့် တန်ဖိုးမဆို
ဥပမာများ	'A' IS 'A' → TRUE 'A' IS 'a' → FALSE 4 IS 4 → TRUE 4 IS 2+2 → TRUE 4 IS 2 → FALSE @geometry IS NULL → 0, if your geometry is not NULL

13.2.19.18. IS NOT

အကယ်၍ a သည် b နှင့် မတူညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a IS NOT b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	'a' IS NOT 'b' → TRUE 'a' IS NOT 'a' → FALSE 4 IS NOT 2+2 → FALSE

13.2.19.19. LIKE

အကယ်၍ ပထမဆုံးသတ်မှတ်ချက် (first parameter) သည် ပံ့ပိုးထားသည့် ပုံစံ (pattern) နှင့်ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။ ကိန်းဂဏန်းများနှင့်လည်း လုပ်ဆောင်နိုင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	string/number LIKE pattern
Argument များ	string/number - တန်ဖိုး pattern - တန်ဖိုးများကို နှိုင်းယှဉ်ရန် ပုံစံ။ ‘%’ ကို wildcard တစ်ခုအဖြစ်၊ ‘_’ ကို single char အဖြစ်နှင့် ‘\\’ ကို special character များကို ရှောင်ရှားရန် အသုံးပြုနိုင်ပါသည်။
ဥပမာများ	'A' LIKE 'A' → TRUE 'A' LIKE 'a' → FALSE 'A' LIKE 'B' → FALSE 'ABC' LIKE 'B' → FALSE 'ABC' LIKE '_B_' → TRUE 'ABCD' LIKE '_B_' → FALSE 'ABCD' LIKE '_B%' → TRUE 'ABCD' LIKE '%B%' → TRUE '1%' LIKE '1\\%' → TRUE '1_' LIKE '1\\%' → FALSE

13.2.19.20. NOT

အခြေအနေ (condition) တစ်ခုကို အချည်းအနှီး (Negates) ဖြစ်စေသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	NOT a
Argument များ	a - အခြေအနေ
ဥပမာများ	NOT 1 → FALSE NOT 0 → TRUE

13.2.19.21. NOT BETWEEN

အကယ်၍ တန်ဖိုးသည့် သတ်မှတ်ထားသည့် အပိုင်းအခြားပမာဏ (range) အတွင်းတွင် မရှိပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။ အပိုင်းအခြားပမာဏသည် အစနှင့်အဆုံးသတ် (bounds) များပါ အပါအဝင်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	value NOT BETWEEN lower_bound AND higher_bound
Argument များ	value - အပိုင်းအခြားပမာဏ (range) တစ်ခုနှင့် နှိုင်းယှဉ်ရန် တန်ဖိုး။ ၎င်းသည် string တစ်ခု၊ ဂဏန်းတစ်ခု သို့မဟုတ် ရက်စွဲတစ်ခု ဖြစ်နိုင်ပါသည်။ lower_bound AND higher_bound - range bounds (အပိုင်းအခြားပမာဏ နယ်နိမိတ်)
ဥပမာများ	'B' NOT BETWEEN 'A' AND 'C' → FALSE 1.0 NOT BETWEEN 1.1 AND 1.2 → TRUE 2 NOT BETWEEN 2 AND 3 → FALSE 'B' NOT BETWEEN 'a' AND 'c' → TRUE lower('B') NOT BETWEEN 'a' AND 'b' → FALSE

Note

value NOT BETWEEN lower_bound AND higher_bound သည် “value < lower_bound OR value > higher_bound” နှင့်အတူတူဖြစ်ပါသည်။

ထပ်မံဖတ်ရှုရန်- BETWEEN

13.2.19.22. OR

အခြေအနေ (condition) a သို့မဟုတ် b သည် true ဖြစ်သောအခါတွင် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	a OR b
Argument များ	a - အခြေအနေ b - အခြေအနေ
ဥပမာများ	4 = 2+2 OR 1 = 1 → TRUE 4 = 2+2 OR 1 = 2 → TRUE 4 = 2   OR 1 = 2 → FALSE

13.2.19.23. []

Index (အညွှန်းကိန်း) operator ။ Array တစ်ခု သို့မဟုတ် map တန်ဖိုးတစ်ခုမှ element တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	[index]
Argument များ	index - array index (အညွှန်း) သို့မဟုတ် map key တန်ဖိုး
ဥပမာများ	array(1,2,3)[0] → 1 array(1,2,3)[2] → 3 array(1,2,3)[-1] → 3 map('a',1,'b',2)['a'] → 1 map('a',1,'b',2)['b'] → 2

ထပ်မံဖတ်ရှုရန်- array_get ၊ map_get

13.2.19.24. ^

တန်ဖိုးနှစ်ခု၏ ပါဝါ (Power)။

Syntax (ဝါကျဖွဲ့ပုံ)	a ^ b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	5 ^ 4 → 625 5 ^ NULL → NULL

13.2.19.25. ||

တန်ဖိုး နှစ်ခုကို string တစ်ခုအဖြစ်သို့ ချိတ်ဆက်ပေးပါသည်။

အကယ်၍ တန်ဖိုးများထဲမှ တစ်ခုသည် NULL ဖြစ်ပါက ရလဒ်သည် NULL ဖြစ်လိမ့်မည်ဖြစ်ပါသည်။ မတူညီသည့် လုပ်ဆောင်ချက်များ အတွက် CONCAT function ကို ကြည့်ပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	a || b
Argument များ	a - တန်ဖိုး b - တန်ဖိုး
ဥပမာများ	'Here' || ' and ' || 'there' → ‘Here and there’ 'Nothing' || NULL → NULL 'Dia: ' || "Diameter" → ‘Dia: 25’ 1 || 2 → ‘12’

ထပ်မံဖတ်ရှုရန်- concat ၊ +

13.2.19.26. ~

String တန်ဖိုးတစ်ခု အပေါ်တွင် regular expression ကိုက်ညီမှုတစ်ခုကို ဆောင်ရွက်ပေးပါသည်။ Backslash characters () သည် နှစ်ချက်ဖြစ်ရမည်ဖြစ်သည် (ဥပမာအားဖြင့်- white space character တစ်ခုနှင့် ကိုက်ညီရန် “\\s”)။

Syntax (ဝါကျဖွဲ့ပုံ)	string ~ regex
Argument များ	string - string တန်ဖိုးတစ်ခု regex - regular expression တစ်ခု။ Slash () များသည် escape ဖြစ်ရမည်ဖြစ်သည်၊ ဥပမာ \\d
ဥပမာများ	'hello' ~ 'll' → TRUE 'hello' ~ '^ll' → FALSE 'hello' ~ 'llo$' → TRUE 'abc123' ~ '\\d+' → TRUE

ထပ်မံဖတ်ရှုရန်- regexp_match

13.2.20. လုပ်ငန်းဆောင်ရွက်မှုဆိုင်ရာ Function များ (Processing Functions)

ဤအုပ်စုတွင် processing algorithm များပေါ်တွင် လုပ်ဆောင်သည့် function များ ပါဝင်သည်။

13.2.20.1. parameter

Processing algorithm ထည့်သွင်းအသုံးပြုသော parameter တစ်ခု၏ တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	parameter(name)
Argument များ	name - သက်ဆိုင်ရာ ထည့်သွင်းအသုံးပြုသော parameter ၏အမည်
ဥပမာများ	parameter('BUFFER_SIZE') → 5.6

13.2.21. Raster Function များ (Rasters Functions)

ဤအုပ်စုတွင် raster layer ပေါ်တွင် လုပ်ဆောင်သည့် function များ ပါဝင်သည်။

13.2.21.1. raster_attributes

Field အမည်များကို key များအဖြစ် နှင့် raster attribute ဇယားတန်ဖိုးများကို ပေးထားသော raster တန်ဖိုးနှင့်ကိုက်ညီသော attribute ဇယားထည့်သွင်းထားမှုမှ တန်ဖိုးများအဖြစ် ပါဝင်သည့် map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	raster_attributes(layer, band, value)
Argument များ	layer - raster layer တစ်ခု၏ အမည် သို့မဟုတ် id band - သက်ဆိုင်ရာ attribute ဇယားရှာဖွေမှုအတွက် band (လှိုင်းအလွှာ) နံပါတ် value - raster တန်ဖိုး
ဥပမာများ	raster_attributes('vegetation', 1, raster_value('vegetation', 1, make_point(1,1))) → {‘class’: ‘Vegetated’, ‘subclass’: ‘Trees’}

13.2.21.2. raster_statistic

Raster layer တစ်ခုမှ စာရင်းအင်းအချက်အလက်များ (statistics) များကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	raster_statistic(layer, band, property)
Argument များ	layer - raster layer အမည် သို့မဟုတ် layer ID တစ်ခုကို ကိုယ်စားပြုသော string တစ်ခု band - raster layer မှ band နံပါတ်ကို ကိုယ်စားပြုသော ကိန်းပြည့်၊ 1 မှ စတင်ပါသည်။ property - ပြန်ထုတ်ပေးမည့် ဂုဏ်သတ္တိ (property) နှင့်သက်ဆိုင်သော string တစ်ခု။ ဆီလျော်မှုရှိသော ရွေးချယ်စရာများမှာ- min: အနည်းဆုံးတန်ဖိုး max: အများဆုံးတန်ဖိုး avg: ပျမ်းမျှတန်ဖိုး stdev: တန်ဖိုးများ၏ စံတိမ်းချက် range: တန်ဖိုးများ၏ အပိုင်းအခြား (အများဆုံး - အနည်းဆုံး) sum: raster မှ တန်ဖိုးများအားလုံး၏ ပေါင်းလဒ်
ဥပမာများ	raster_statistic('lc',1,'avg') → ‘lc’ raster layer ၏ band 1 မှ ပျှမ်းမျှတန်ဖိုး raster_statistic('ac2010',3,'min') → ‘ac2010’ raster layer ၏ band 3 မှ အနည်းဆုံးတန်ဖိုး

13.2.21.3. raster_value

ပေးထားသော point ၌ တွေ့ရှိရသော raster တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	raster_value(layer, band, point)
Argument များ	layer - raster layer တစ်ခု၏ အမည် သို့မဟုတ် id band - တန်ဖိုးကို နမူနာယူမည့် band နံပါတ် point - point ဂျီဩမေတြီ (အစိတ်အပိုင်းတစ်ခုထက်ပိုပါသော multipart ဂျီဩမေတြီများအတွက် NULL တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးပါလိမ့်မည်)
ဥပမာများ	raster_value('dem', 1, make_point(1,1)) → 25

13.2.22. မှတ်တမ်းနှင့် အချက်အလက်များဆိုင်ရာ Function များ (Record and Attributes Functions)

ဤအုပ်စုတွင် မှတ်တမ်း သတ်မှတ်ပေးသည့်အရာ (record identifier) များပေါ်တွင် လုပ်ဆောင်သည့် function များ ပါဝင်သည်။

13.2.22.1. attribute

Feature တစ်ခုမှ အချက်အလက် (attribute) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Variant 1 (မူကွဲ 1)

လက်ရှိ feature မှ attribute တစ်ခု၏ တန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	attribute(attribute_name)
Argument များ	attribute_name - ပြန်ထုတ်ပေးမည့် attribute ၏ အမည်
ဥပမာများ	attribute( 'name' ) → လက်ရှိ feature အတွက် ‘name’ attribute တွင် သိမ်းဆည်းထားသည့်တန်ဖိုး

Variant 2 (မူကွဲ 2)

သတ်မှတ်မည့် target (ရည်ရွယ်သည့်) feature နှင့် attribute အမည် ကို ခွင့်ပြုပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	attribute(feature, attribute_name)
Argument များ	feature - feature တစ်ခု attribute_name - ပြန်ထုတ်ပေးမည့် attribute ၏ အမည်
ဥပမာများ	attribute( @atlas_feature, 'name' ) → လက်ရှိ atlas feature အတွက် ‘name’ attribute တွင် သိမ်းဆည်းထားသည့်တန်ဖိုး

13.2.22.2. attributes

Field အမည်များသည် map key များအဖြစ်ပါဝင်သည့် feature တစ်ခုမှ attribute အားလုံးပါဝင်သော map (ပုံဖော်ချက်) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Variant 1 (မူကွဲ 1)

လက်ရှိ feature မှ attribute များအားလုံး၏ map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	attributes()
ဥပမာများ	attributes()['name'] → လက်ရှိ feature အတွက် ‘name’ attribute တွင် သိမ်းဆည်းထားသည့်တန်ဖိုး

Variant 2 (မူကွဲ 2)

သတ်မှတ်မည့် target (ရည်ရွယ်သည့်) feature ကို ခွင့်ပြုပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	attributes(feature)
Argument များ	feature - feature တစ်ခု
ဥပမာများ	attributes( @atlas_feature )['name'] → လက်ရှိ atlas feature အတွက် ‘name’ attribute တွင် သိမ်းဆည်းထားသည့်တန်ဖိုး

ထပ်မံဖတ်ရှုရန်- မြေပုံ Function များ (Maps Functions)

13.2.22.3. $currentfeature

အကဲဖြတ်သုံးသပ်ခြင်း (evaluate) ပြုလုပ်ခံထားရသည့် လက်ရှိ feature ကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းကို လက်ရှိ feature မှ attribute တန်ဖိုးများကို သုံးသပ်ခြင်းပြုလုပ်ရန်အတွက် ‘attribute’ function နှင့်အတူ အသုံးပြုနိုင်ပါသည်။ သတိပေးချက် - ဤလုပ်ဆောင်ချက်သည် အပြစ်အနာအဆာ ရှိနေပါသည်။ ၎င်းအစား @feature variable ကို အစားထိုး အသုံးပြုရန် အကြံပြုအပ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	$currentfeature
ဥပမာများ	attribute( $currentfeature, 'name' ) → လက်ရှိ feature အတွက် ‘name’ attribute တွင် သိမ်းဆည်းထားသည့်တန်ဖိုး

13.2.22.4. display_expression

Layer တစ်ခုထဲရှိ ပေးထားသည့် feature တစ်ခုအတွက် ပြသမှုဆိုင်ရာခိုင်းစေချက် (display expression) တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ Expression ကို default အားဖြင့် အကဲဖြတ်သုံးသပ်ပါသည်။ သုည၊ တစ်ခု သို့မဟုတ် တစ်ခုထက်ပိုသော argument များနှင့်အတူ အသုံးပြုနိုင်ပါသည်။ အသေးစိတ်ကို အောက်တွင်ကြည့်ပါ။

No parameters (သတ်မှတ်ချက်များမရှိပါ)

အကယ်၍ သတ်မှတ်ချက်များမရှိ (no parameters) ပါက function သည် လက်ရှိ layer ထဲရှိ လက်ရှိ feature ၏ display expression ကို အကဲဖြတ်သုံးသပ်မည် (evaluate) ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	display_expression()
ဥပမာများ	display_expression() → လက်ရှိ layer ထဲရှိ လက်ရှိ feature ၏ display expression

One ‘feature’ parameter (‘feature’ သတ်မှတ်ချက်တစ်ခု)

အကယ်၍ ‘feature’ သတ်မှတ်ချက်တစ်ခုတည်းသာ ဖြစ်ပါက function သည် လက်ရှိ layer မှ သတ်မှတ်ထားသည့် feature ကို အကဲဖြတ်သုံးသပ်မည် (evaluate) ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	display_expression(feature)
Argument များ	feature - အကဲဖြတ်သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature
ဥပမာများ	display_expression(@atlas_feature) → လက်ရှိ atlas feature ၏ display expression

Layer and feature parameters ** **(Layer နှင့် feature သတ်မှတ်ချက်များ)

အကယ်၍ လုပ်ဆောင်ချက်သည် Layer နှင့် လက္ခဏာအမှတ်အသား နှစ်ခုလုံးဖြစ်ပါက ၎င်းသည် သတ်မှတ်ထားသည့် layer မှ သတ်မှတ်ထားသည့် လက္ခဏာအမှတ်အသားကို သုံးသပ်ခြင်းပြုလုပ်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	display_expression(layer, feature, [evaluate=true]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	layer - layer (သို့မဟုတ် ၎င်း၏ ID သို့မဟုတ် အမည်) feature - အကဲဖြတ်သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature evaluate - True ဖြစ်လျှင် expression ကို အကဲဖြတ်သုံးသပ်ရမည်ဖြစ်သည်။ အကယ်၍ false ဖြစ်ပါက expression သည် string literal (string literal တွင် character များ၏ sequence တစ်ခု သို့မဟုတ် ( “ “ ) ထဲတွင် ထည့်သွင်းထားသည့် escape sequence များပါရှိပါသည်) တစ်ခုအဖြစ်သာ ပြန်လည်ရရှိမည်ဖြစ်ပါသည်။ (၎င်းသည် ‘eval’ function ကို အသုံးပြု၍ နောက်ပိုင်းတွင် အကဲဖြတ်သုံးသပ်ခံရရန် ဖြစ်နိုင်ချေရှိသည်)
ဥပမာများ	display_expression( 'streets', get_feature_by_id('streets', 1)) → ‘streets’ layer အပေါ်ရှိ ID 1 ဖြစ်သည့် feature ၏ display expression display_expression('a_layer_id', @feature, 'False') → အကဲဖြတ်သုံးသပ်ခြင်း မပြုလုပ်ထားသော ပေးထားသည့် feature ၏ display expression

13.2.22.5. feature_id

Feature ၏ သိသာထင်ရှားသည့် ID တစ်ခုကို ပြန်ထုတ်ပေးပါသည် သို့မဟုတ် အကယ်၍ feature သည် valid(ကျိုးကြောင်းဆီလျော်မှု) မဖြစ်ပါက NULL ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	feature_id(feature)
Argument များ	feature - feature object တစ်ခု
ဥပမာများ	feature_id( @feature ) → လက်ရှိ feature ၏ ID

ထပ်မံဖတ်ရှုရန်- get_feature_by_id

13.2.22.6. get_feature

ပေးထားသည့် attribute တန်ဖိုးတစ်ခုနှင့် ကိုက်ညီသော layer တစ်ခု၏ ပထမဆုံး feature ကို ပြန်ထုတ်ပေးပါသည်။

Single value variant (တစ်ခုတည်းသောတန်ဖိုးမူကွဲ)

Layer ID နှင့်အတူ column တစ်ခုနှင့် တန်ဖိုးတစ်ခုတို့ကို သတ်မှတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	get_feature(layer, attribute, value)
Argument များ	layer - layer အမည် သို့မဟုတ် ID attribute - ကိုက်ညီမှုအတွက်အသုံးပြုရန် attribute အမည် value - ကိုက်ညီမှုအတွက်အသုံးပြုရန် attribute တန်ဖိုး
ဥပမာများ	get_feature('streets','name','main st') → “name” field တွင် “main st” တန်ဖိုးနှင့်အတူ “streets” layer ထဲတွင် တွေ့ရှိသည့် ပထမဆုံး feature

Map variant (ပုံဖော်ချက်မူကွဲ)

Layer ID နှင့်အတူ အသုံးပြုမည့် column (key) များနှင့် ၎င်းတို့၏ သက်ဆိုင်ရာတန်ဖိုးများ ပါဝင်သော map တစ်ခု။

Syntax (ဝါကျဖွဲ့ပုံ)	get_feature(layer, attribute)
Argument များ	layer - layer အမည် သို့မဟုတ် ID attribute - အသုံးပြုရန် column နှင့် တန်ဖိုးအတွဲများ (value pairs) ပါဝင်သည့် map
ဥပမာများ	get_feature('streets',map('name','main st','lane_num','4')) → “name” field ထဲရှိ “main st” တန်ဖိုးနှင့် “lane_num” field ထဲရှိ “4” တန်ဖိုးပါဝင်သော “streets” layer ထဲတွင် တွေ့ရှိသည့် ပထမဆုံး feature

13.2.22.7. get_feature_by_id

Layer တစ်ခုအပေါ်တွင် id တစ်ခုပါရှိသည့် feature ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	get_feature_by_id(layer, feature_id)
Argument များ	layer - layer ၊ layer အမည် သို့မဟုတ် layer id feature_id - ပြန်လည်ရရှိသင့်သည့် feature ၏ id
ဥပမာများ	get_feature_by_id('streets', 1) → “streets” layer အပေါ်ရှိ id 1 ပါရှိသည့် feature

ထပ်မံဖတ်ရှုရန်- feature_id

13.2.22.8. $id

လက်ရှိ ဇယားတန်း (row) ၏ feature id ကို ပြန်ထုတ်ပေးပါသည်။ သတိပေးချက် - ဤလုပ်ဆောင်ချက်သည် အပြစ်အနာအဆာပါဝင်နေပါသည်။ ၎င်းအစား @id variable ကို အစားထိုး အသုံးပြုရန် အကြံပြုအပ်ပါသည်။

Syntax	$id
ဥပမာများ	$id → 42

ထပ်မံဖတ်ရှုရန်- feature_id ၊ get_feature_by_id

13.2.22.9. is_attribute_valid

အကယ်၍ သီးခြား feature attribute တစ်ခုသည် ကန့်သတ်ချက် (constraints) များအားလုံးနှင့် ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_attribute_valid(attribute, [feature], [layer], [strength]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	attribute - attribute အမည်တစ်ခု feature - feature တစ်ခု။ အကယ်၍ သတ်မှတ်မထားပါက လက်ရှိ feature ကို အသုံးပြုလိမ့်မည်ဖြစ်သည်။ layer - vector layer တစ်ခု။ အကယ်၍ သတ်မှတ်မထားပါက လက်ရှိ layer ကို အသုံးပြုလိမ့်မည်ဖြစ်သည်။ strength - သတ်မှတ်ထားသည့် ကန့်သတ်ချက်အမျိုးအစား (constraint type) သို့ လျှော့ချနိုင် (narrow down) စေရန် ‘hard’ သို့မဟုတ် ‘soft’ သို့ သတ်မှတ်ပါ။ အကယ်၍ သတ်မှတ်မထားပါက function သည် hard သို့မဟုတ် soft ကန့်သတ်ချက် တစ်ခုမဟုတ်တစ်ခု မအောင်မြင်ပါက FALSE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။
ဥပမာများ	is_attribute_valid('HECTARES') → အကယ်၍ “HECTARES” field ထဲရှိ လက်ရှိ feature ၏ တန်ဖိုးသည် ကန့်သတ်ချက်များအားလုံးကို ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။ is_attribute_valid('HOUSES',get_feature('my_layer', 'FID', 10), 'my_layer') → အကယ်၍ ‘my_layer’ ထဲရှိ “FID”=10 ရှိသည့် feature မှ “HOUSES” field ထဲရှိ တန်ဖိုးသည် ကန့်သတ်ချက်များအားလုံးနှင့် မကိုက်ညီပါက FALSE ကိုပြန်ထုတ်ပေးပါမည်။

ထပ်မံဖတ်ရှုရန်- ကန့်သတ်ချက်များ (Constraints)

13.2.22.10. is_feature_valid

အကယ်၍ feature တစ်ခုသည် field constraints (ကန့်သတ်ချက်များ) အားလုံးနှင့် ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_feature_valid([feature], [layer], [strength]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	feature - feature တစ်ခု။ အကယ်၍ သတ်မှတ်မထားပါက လက်ရှိ feature ကို အသုံးပြုလိမ့်မည်ဖြစ်သည်။ layer - vector layer တစ်ခု။ အကယ်၍ သတ်မှတ်မထားပါက လက်ရှိ layer ကို အသုံးပြုလိမ့်မည်ဖြစ်သည်။ strength - သတ်မှတ်ထားသည့် ကန့်သတ်ချက်အမျိုးအစား (constraint type) သို့ လျှော့ချနိုင် (narrow down) စေရန် ‘hard’ သို့မဟုတ် ‘soft’ သို့ သတ်မှတ်ပါ။ အကယ်၍ သတ်မှတ်မထားပါက function သည် hard သို့မဟုတ် soft ကန့်သတ်ချက် တစ်ခုမဟုတ်တစ်ခု မအောင်မြင်ပါက FALSE ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။
ဥပမာများ	is_feature_valid(strength:='hard') → အကယ်၍ လက်ရှိ feature ၏ field များအားလုံးသည် ၎င်းတို့၏ hard constraints များနှင့် ကိုက်ညီပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။ is_feature_valid(get_feature('my_layer', 'FID', 10), 'my_layer') → အကယ်၍ ‘my_layer’ ထဲရှိ “FID”=10 ရှိသည့် feature မှ field များအားလုံးသည် ကန့်သတ်ချက်များအားလုံးနှင့် မကိုက်ညီပါက FALSE ကိုပြန်ထုတ်ပေးပါမည်။

ထပ်မံဖတ်ရှုရန်- ကန့်သတ်ချက်များ (Constraints)

13.2.22.11. is_selected

အကယ်၍ feature တစ်ခုသည် ရွေးချယ်ခြင်းခံရ (selected) ပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။ Argument မပါရှိသော၊ argument တစ်ခု သို့မဟုတ် နှစ်ခုနှင့်အတူ အသုံးပြုနိုင်ပါသည်။ အသေးစိတ်ကို အောက်တွင်ကြည့်ပါ။

No parameters (သတ်မှတ်ချက်များမရှိပါ)

အကယ်၍ parameter များမရှိပါက လက်ရှိ layer ထဲရှိ လက်ရှိ feature သည် ရွေးချယ်ခြင်းခံရ (selected) ပါက function သည် TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_selected()
ဥပမာများ	is_selected() → လက်ရှိ layer ထဲရှိ လက်ရှိ feature အနေဖြင့် ရွေးချယ်ခံရ (selected) ပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။

One ‘feature’ parameter (‘feature’ သတ်မှတ်ချက်တစ်ခု)

အကယ်၍ ‘feature’ သတ်မှတ်ချက် တစ်ခုတည်းသာဖြစ်ပါက လက်ရှိ layer မှ သတ်မှတ်ထားသည့် feature သည် ရွေးချယ်ခံရပါက TRUE ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_selected(feature)
Argument များ	feature - ရွေးချယ်မှုအတွက် စစ်ဆေးမှုပြုလုပ်သင့်သည့် feature
ဥပမာများ	is_selected(@atlas_feature) → အကယ်၍ လက်ရှိ atlas feature ကို ရွေးချယ်ထားပါက TRUE ကိုပြန်ထုတ်ပေးပါမည်။ is_selected(get_feature('streets', 'name', 'Main St.')) → အသက်ဝင်နေသည့် (active) “streets” layer ပေါ်ရှိ “Main St.” ဆိုသည့် သိသာထင်ရှားသောအရာကို ရွေးချယ်ထားပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။ is_selected(get_feature_by_id('streets', 1)) → အသက်ဝင်နေသည့် (active) “streets” layer ပေါ်ရှိ id 1 ရှိသည့် feature ကို ရွေးချယ်ထားပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။

Two parameters (သတ်မှတ်ချက်နှစ်ခု)

အကယ်၍ function ကို layer နှင့် feature နှစ်ခုလုံးဖြင့် သတ်မှတ်ခိုင်းစေဆောင်ရွက်ပါက သတ်မှတ်ထားသည့် layer မှ သတ်မှတ်ထားသော feature သည် ရွေးချယ်ခံထားရပါက TRUE ကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	is_selected(layer, feature)
Argument များ	layer - ရွေးချယ်မှုအတွက် စစ်ဆေးခြင်းပြုလုပ်သင့်သည့် layer (၎င်း၏ ID သို့မဟုတ် အမည်) feature - ရွေးချယ်မှုအတွက် စစ်ဆေးမှုပြုလုပ်သင့်သည့် feature
ဥပမာများ	is_selected( 'streets', get_feature('streets', 'name', "street_name")) → လက်ရှိ အဆောက်အဦး၏ လမ်းသည် ရွေးချယ်ခြင်းခံထားရပါက TRUE ကို ပြန်ထုတ်ပေးပါမည် (building layer တွင် ‘street_name’ ဟုခေါ်သော field တစ်ခုနှင့် ‘streets’ layer တွင် သိသာထင်ရှားသောတန်ဖိုးများပါရှိသည့် ‘name’ ဟုခေါ်သော field တစ်ခုပါရှိသည်ဟု ယူဆခြင်းအားဖြင့်)။ is_selected( 'streets', get_feature_by_id('streets', 1)) → “streets” layer ပေါ်ရှိ id 1 ရှိသည့် feature သည် ရွေးချယ်ခြင်းခံထားရပါက TRUE ကို ပြန်ထုတ်ပေးပါမည်။

13.2.22.12. maptip

Layer တစ်ခုထဲရှိ ပေးထားသည့် feature တစ်ခုအတွက် maptip (MapTips သည် feature ၊ surface သို့မဟုတ် raster image ပေါ်တွင် pointer ကို နေရာချသည့်အခါတွင် အချက်အလက် သို့မဟုတ် ပြသမှုဆိုင်ရာဖော်ပြချက်စသော အချက်အလက်များကို ပံ့ပိုးပေးပါသည်) ကို ပြန်ထုတ်ပေးပါသည်။ Expression ကို default အားဖြင့် အကဲဖြတ်သုံးသပ်မည်ဖြစ်ပါသည်။ Argument မပါရှိသော၊ တစ်ခု သို့မဟုတ် တစ်ခုထက်ပိုသော argument များနှင့်အတူအသုံးပြုနိုင်ပါသည်။ အသေးစိတ်ကို အောက်တွင် ကြည့်ရှုပါ။

No parameters (သတ်မှတ်ချက်များမရှိပါ)

အကယ်၍ သတ်မှတ်ချက်များမပါရှိပဲ သတ်မှတ်ခိုင်းစေဆောင်ရွက်ပါက function သည် လက်ရှိ layer ထဲရှိ လက်ရှိ feature ၏ maptip ကို အကဲဖြတ်သုံးသပ်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	maptip()
ဥပမာများ	maptip() → လက်ရှိ layer ထဲရှိ လက်ရှိ feature ၏ maptip

One ‘feature’ parameter (‘feature’ သတ်မှတ်ချက်တစ်ခု)

အကယ်၍ ‘feature’ သတ်မှတ်ချက် တစ်ခုတည်းသာ ဖြစ်ပါက function သည် လက်ရှိ layer မှ သတ်မှတ်ထားသည့် feature ကို အကဲဖြတ်သုံးသပ်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	maptip(feature)
Argument များ	feature - သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature
ဥပမာမာျး	maptip(@atlas_feature) → လက်ရှိ atlas feature ၏ maptip

Layer and feature parameters (Layerနှင့် feature သတ်မှတ်ချက်များ)

အကယ်၍ function ကို layer နှင့် feature နှစ်ခုလုံးဖြင့် သတ်မှတ်ခိုင်းစေဆောင်ရွက်ပါက ၎င်းသည် သတ်မှတ်ထားသော layer မှ သတ်မှတ်ထားသော feature ကို အကဲဖြတ်သုံးသပ်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	maptip(layer, feature, [evaluate=true]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	layer - layer (၎င်း၏ ID သို့မဟုတ် အမည်) feature - သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature evaluate - True ဖြစ်လျှင် expression ကို အကဲဖြတ်သုံးသပ်ရမည်ဖြစ်သည်။ အကယ်၍ false ဖြစ်ပါက expression သည် string literal အဖြစ်သာ ပြန်လည်ရရှိမည်ဖြစ်ပါသည် (၎င်းသည် ‘eval_template’ function ကို အသုံးပြု၍ နောက်ပိုင်းတွင် အကဲဖြတ်သုံးသပ်ခံရရန် ဖြစ်နိုင်ချေရှိသည်)။
ဥပမာများ	maptip('streets', get_feature_by_id('streets', 1)) → “streets” layer ပေါ်ရှိ id 1 ရှိသည့် feature ၏ maptip maptip('a_layer_id', @feature, 'False') → သုံးသပ်ခြင်းမပြုလုပ်ထားသော ပေးထားသည့် feature ၏ maptip

13.2.22.13. num_selected

ပေးထားသည့် layer တစ်ခုအပေါ်တွင် ရွေးချယ်မှုပြုလုပ်ထားသော feature အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။ Default အားဖြင့် expression ကို အကဲဖြတ်သုံးသပ်သည့် layer အပေါ်တွင် အလုပ်လုပ်ဆောင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	num_selected([layer=current layer]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	layer - ရွေးချယ်မှုကို စစ်ဆေးမည့် layer (သို့မဟုတ် ၎င်း၏ ID သို့မဟုတ် အမည်)
ဥပမာများ	num_selected() → လက်ရှိ layer ပေါ်ရှိ ရွေးချယ်ခံထားရသည့် feature အရေအတွက် num_selected('streets') → streets layer ပေါ်ရှိ ရွေးချယ်ခံထားရသည့် feature အရေအတွက်

13.2.22.14. represent_attributes

Attribute အမည်များကို key များအဖြစ်နှင့် သတ်မှတ်ပြင်ဆင်ထားသော ကိုယ်စားပြုတန်ဖိုးများကို တန်ဖိုးများအဖြစ် ပါရှိသည့် map တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ Attribute များအတွက် ကိုယ်စားပြုတန်ဖိုးများသည် attribute တစ်ခုချင်းစီအတွက် စီစဉ်သတ်မှတ်ထားသည့် widget အမျိုးအစားအပေါ်တွင် မူတည်ပါသည်။ Argument မပါရှိသော၊ တစ်ခု သို့မဟုတ် တစ်ခုထက်ပိုသော argument များနှင့်အတူ အသုံးပြုနိုင်ပါသည်။ အသေးစိတ်ကို အောက်တွင်ကြည့်ရှုပါ။

No parameters (သတ်မှတ်ချက်များမရှိပါ)

အကယ်၍ သတ်မှတ်ချက်များမရှိပါ ဖြစ်ပါက function သည် လက်ရှိ layer ထဲရှိ လက်ရှိ feature ၏ attribute များ၏ ကိုယ်စားပြုဖော်ပြမှုကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	represent_attributes()
ဥပမာများ	represent_attributes() → လက်ရှိ feature အတွက် attribute များ၏ ကိုယ်စားပြုဖော်ပြမှု

One ‘feature’ parameter (‘feature’ သတ်မှတ်ချက်တစ်ခု)

အကယ်၍ ‘feature’ သတ်မှတ်ချက်တစ်ခုတည်းသာ ဖြစ်ပါက function သည် လက်ရှိ layer မှ သတ်မှတ်ထားသည့် feature ၏ attribute များကို ကိုယ်စားပြုဖော်ပြမှုအား ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	display_expression(feature)
Argument များ	feature - အကဲဖြတ်သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature
ဥပမာများ	represent_attributes(@atlas_feature) → လက်ရှိ layer ထဲမှ သတ်မှတ်ထားသည့် feature အတွက် attribute များ၏ ကိုယ်စားပြုဖော်ပြမှု

Layer and feature parameters (Layer နှင့် feature သတ်မှတ်ချက်များ)

အကယ်၍ ‘layer’ နှင့် ‘feature’ သတ်မှတ်ချက် ဖြစ်ပါက function သည် သတ်မှတ်ထားသည့် layer မှ သတ်မှတ်ထားသော feature ၏ attribute များ၏ ကိုယ်စားပြုဖော်ပြမှုကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	represent_attributes(layer, feature)
Argument များ	layer - layer (သို့မဟုတ် ၎င်း၏ ID သို့မဟုတ် အမည်) feature - အကဲဖြတ်သုံးသပ်ခြင်းပြုလုပ်သင့်သည့် feature
ဥပမာများ	represent_attributes('atlas_layer', @atlas_feature) → သတ်မှတ်ထားသည့် layer မှ သတ်မှတ်ထားသော feature အတွက် attribute များ၏ ကိုယ်စားပြုဖော်ပြမှု

ထပ်မံဖတ်ရှုရန်- represent_value

13.2.22.15. represent_value

Field တန်ဖိုးတစ်ခုအတွက် စီစဉ်သတ်မှတ်ထားသော (configured) ကိုယ်စားပြုတန်ဖိုးကို ပြန်ထုတ်ပေးပါသည်။ ၎င်းသည် စီစဉ်သတ်မှတ်ထားသော (configured) widget အမျိုးအစားပေါ်တွင် မူတည်ပါသည်။ တစ်ခါတစ်ရံ ၎င်းသည် ‘Value Map’ widget များအတွက် အသုံးဝင်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	represent_value(value, [fieldName]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	value - ဖြေရှင်း (resolve) သင့်သည့် တန်ဖိုး။ များသောအားဖြင့် field တစ်ခုနှင့်အလားတူပါသည်။ fieldName - မည်သည့် widget configuration ကို ထည့်သွင်းသင့်သည်အတွက် field အမည်။
ဥပမာများ	represent_value("field_with_value_map") → တန်ဖိုးအတွက် ကျိုးကြောင်းဖော်ပြချက် represent_value('static value', 'field_name') → static value (တစ်သမတ်တည်းတန်ဖိုး) အတွက် ကျိုးကြောင်းဖော်ပြချက်

ထပ်မံဖတ်ရှုရန်- widget types (widget အမျိုးအစားများ)၊ represent_attributes

13.2.22.16. sqlite_fetch_and_increment

sqlite database များထဲတွင် အလိုအလျောက်တိုးပွားလာသည့်တန်ဖိုးများ (autoincrementing values) ကို စီမံခန့်ခွဲပါသည်။

SQlite default တန်ဖိုးများကို insert (ထည့်သွင်းမှု) အပေါ်တွင်သာ အသုံးပြုနိုင်ပြီး ကြိုတင်ကူးပြောင်းခြင်း (prefetched) မပြုလုပ်နိုင်ပါ။

၎င်းသည် database ထဲတွင် row များကို မဖန်တီးခင်တွင် AUTO_INCREMENT (အလိုအလျောက်တိုးပွားလာမှု) မှတဆင့် တိုးပွားလာသည့် (incremented) primary key တစ်ခုကို ရယူနိုင်ခြင်း မရှိအောင် ပြုလုပ်ပါသည်။ မှတ်စု- postgres ဖြင့် ၎င်းသည် evaluate default values မှတစ်ဆင့် အလုပ်လုပ်ဆောင်ပါသည်။

Feature အသစ်များကို Relation (ဆက်နွယ်မှု) များနှင့်အတူ ထည့်သွင်းသည့်အခါတွင် parents form(ပုံစံ) ပွင့်နေစဉ်အတွင်း parent feature သည် အပြီးသတ်လုပ်ဆောင်နိုင်ခြင်း (uncommitted) မရှိသေးသဖြင့် parent (ပင်မဇယားရှိ primary key သို့မဟုတ် unique key တစ်ခုကို သိမ်းဆည်းထားသည့် ဇယား) တစ်ခုအတွက် children (foreign key တစ်ခုဖြင့် parent ကို ညွှန်းဆိုသည့် မည်သည့်ဇယားမဆို) များကို ကြိုတင်ထည့်သွင်းထားခြင်းသည် အလွန်ကောင်းမွန်ပါသည်။

ဤကန့်သတ်ချက်ကို ကျော်လွှားနိုင်ရန် ဤ function ကို gpkg ကဲ့သို့သော sqlite အခြေပြု format များပေါ်တွင် သီးခြားဇယားတစ်ခုဖြင့် sequence တန်ဖိုးများ ကို စီမံခန့်ခွဲရန် အသုံးပြုနိုင်ပါသည်။

sequence id (filter_attribute နှင့် filter_value) တစ်ခုအတွက် sequence table ကို စစ်ထုတ်မှုပြုလုပ်မည်ဖြစ်ပြီး id_field ၏ လက်ရှိတန်ဖိုးကို 1 တိုးသွားမည်ဖြစ်ပြီး တိုးလာမည့် တန်ဖိုးကို ပြန်ထုတ်ပေးမည်ဖြစ်ပါသည်။

အကယ်၍ ထပ်ဆောင်း column များသည် တန်ဖိုးများသတ်မှတ်ရန်လိုအပ်လာပါက default_values map ကို ဤ ရည်ရွယ်ချက်အတွက် အသုံးပြုနိုင်ပါသည်။

Note (မှတ်စု)

ဤ function သည် ရည်ရွယ်ထားသည့် (target) sqlite ဇယားကို ပြင်ဆင်မွမ်းမံပါသည်။ ၎င်းကို attribute များအတွက် default တန်ဖိုး စီစဉ်သတ်မှတ်ခြင်းများ (default value configurations) ဖြင့် အသုံးပြုရန်အတွက် ရည်ရွယ်ပါသည်။

Database parameter သည် layer တစ်ခုဖြစ်နေပြီး layer သည် transaction mode (transaction တစ်ခုတွင် SQL သည် ထည့်သွင်းခြင်း၊ သို့မဟုတ် ဖျက်ခြင်းကဲ့သို့သော တစ်ခုထက်ပိုသည့် လုပ်ငန်းဆောင်တာများကို အလုပ်တစ်ခုတည်းအဖြစ် database တစ်ခုအပေါ်တွင်ဆောင်ရွက်ခြင်းဖြစ်ပါသည်) အတွင်းတွင် ရှိနေသည့်အခါတွင် တန်ဖိုးကို transaction တစ်ခု ၏ သက်တမ်းတစ်လျှောက်တွင် တစ်ကြိမ်သာ ပြန်လည်ရယူခြင်း (retrieved)၊ သိမ်းဆည်ခြင်း (cached) နှင့် တိုးပွားခြင်း (incremented) ပြုလုပ်မည်ဖြစ်ပါသည်။ ထိုသို့ဆောင်ရွက်ခြင်းသည် များစွာသော လုပ်ငန်းစဉ်များကို တူညီသည့် database အပေါ်တွင် တပြိုင်နက်တည်း လုပ်ဆောင်ရာတွင် လုံခြုံစိတ်ချမှုမရှိစေနိုင်ပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	sqlite_fetch_and_increment(database, table, id_field, filter_attribute, filter_value, [default_values]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	database - sqlite file သို့မဟုတ် geopackage layer ရှိရာ လမ်းကြောင်း table - sequence များကို စီမံခန့်ခွဲခြင်းဆောင်ရွက်မည့် ဇယား၏ အမည် id_field - လက်ရှိတန်ဖိုးပါဝင်သည့် field ၏ အမည် filter_attribute - ဤ sequence အတွက် သိသာထင်ရှားသည့်အမှတ်အသားပြုလုပ်မှု (unique identifier) ပါဝင်သည့် field ကို အမည်သတ်မှတ်ပါ။ သိသာထင်ရှားသည့်အညွှန်း (UNIQUE index) တစ်ခုပါရှိရမည်ဖြစ်ပါသည်။ filter_value - အသုံးပြုရန် sequence ၏ အမည် default_values - ဇယားပေါ်ရှိ နောက်ထပ် column များအတွက် default တန်ဖိုးများပါရှိသည့် map ။ ဤတန်ဖိုးများကို အပြည့်အဝကိုးကားခြင်း ပြုလုပ်ရန်လိုအပ်ပါသည်။ Function (လုပ်ဆောင်ချက်) များကို ခွင့်ပြုပါသည်။
ဥပမာများ	sqlite_fetch_and_increment(@layer, 'sequence_table', 'last_unique_id', 'sequence_id', 'global', map('last_change', 'date(''now'')', 'user', '''' || @user_account_name || '''')) → 0 sqlite_fetch_and_increment(layer_property(@layer, 'path'), 'sequence_table', 'last_unique_id', 'sequence_id', 'global', map('last_change', 'date(''now'')', 'user', '''' || @user_account_name || '''')) → 0

ထပ်မံဖတ်ရှုရန်- Data အရင်းအမြစ်ဆိုင် ဂုဏ်သတ္တိများ (Data Sources Properties) ၊ တစ်ခု-မှ-အများ သို့မဟုတ် အများ-မှ-အများ ဆက်သွယ်ချက်များကို ဖန်တီးခြင်း (Creating one or many to many relations)

13.2.22.17. uuid

Qt QUuid::createUuid နည်းလမ်းကို အသုံးပြုပြီး row တစ်ခုချင်းစီအတွက် Universally Unique Identifier (UUID) တစ်ခုကို ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	uuid([format=’WithBraces’]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	format - UUID ကို format ပြုလုပ်သကဲ့သို့ format။ ‘WithBraces’ ၊ ‘WithoutBraces’ သို့မဟုတ် ‘Id128’ ။
ဥပမာများ	uuid() → ‘{0bd2f60f-f157-4a6d-96af-d4ba4cb366a1}’ uuid('WithoutBraces') → ‘0bd2f60f-f157-4a6d-96af-d4ba4cb366a1’ uuid('Id128') → ‘0bd2f60ff1574a6d96afd4ba4cb366a1’

13.2.23. ဆက်နွယ်မှုများ (Relations)

ဤအုပ်စုတွင် လက်ရှိ Project ထဲရှိ ရရှိနိုင်သော relations (ဆက်နွယ်မှု) စာရင်းများကို ၎င်းတို့၏ဖော်ပြချက်များနှင့်အတူ ပါရှိပါသည်။ ၎င်းသည် expression တစ်ခုရေးသားရန်အတွက် သို့မဟုတ် Form တစ်ခုကို စိတ်ကြိုက်ပြင်ဆင်နိုင်ရန်အတွက် relation ID သို့ အမြန်ဝင်ရောက်နိုင်ရန် ဆောင်ရွက်ပေးသည်။ (ဥပမာ- relation_aggregate funcion)

13.2.24. အာရုံခံကိရိယာ Function များ (Sensors Functions)

ဤအုပ်စုတွင် sensor (အာရုံခံကိရိယာ) များနှင့် အပြန်အလှန်လုပ်ဆောင်နိုင်သော function များ ပါဝင်သည်။

13.2.24.1. sensor_data

မှတ်ပုံတင်အသိအမှတ်ပြုထားသော (registered) sensor တစ်ခုမှ နောက်ဆုံးဖမ်းယူထားသော တန်ဖိုး (သို့မဟုတ် တန်ဖိုးအများအပြားကို ပေးပို့သော sensor များအတွက် map တစ်ခုအနေဖြင့် တန်ဖိုးများ) ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	sensor_data(name, [expiration]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	name - sensor အမည် expiration - နောက်ဆုံးဖမ်းယူထားသောတန်ဖိုးမှစတင်၍ ခွင့်ပြုထားသော အများဆုံး မီလီစက္ကန့်
ဥပမာများ	sensor_data('geiger_1') → ‘2000’

13.2.25. စာသား Function များ (String Functions)

ဤအုပ်စုတွင် string (စာသား) များပေါ်တွင် လုပ်ဆောင်နိုင်သည့် function များ ပါဝင်သည် (ဥပမာ- အစားထိုးခြင်း၊ စာလုံးအကြီး (upper case) ပြောင်းလဲခြင်း)။

13.2.25.1. ascii

String တစ်ခု၏ ပထမဆုံး character နှင့်သက်ဆိုင်သော unicode (ယူနီကုဒ်) code ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	ascii(string)
Argument များ	string - ယူနီကုဒ် code သို့ ပြောင်းရန် string
ဥပမာများ	ascii('Q') → 81

13.2.25.2. char

ယူနီကုဒ် code တစ်ခုနှင့် သက်ဆိုင်သော character ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	char(code)
Argument များ	code - unicode ကုဒ်နံပါတ်တစ်ခု
ဥပမာများ	char(81) → ‘Q’

13.2.25.3. concat

String များစွာကို တစ်ခုတည်းအဖြစ်သို့ ပေါင်းစပ်ခြင်း (Concatenates) ပြုလုပ်ပါသည်။ NULL တန်ဖိုးများကို empty (ဗလာ) string များအဖြစ်သို့ ပြောင်းလဲမည်ဖြစ်သည်။ အခြားသောတန်ဖိုးများ(ဂဏန်းများကဲ့သို့သော) ကို string များအဖြစ်သို့ ပြောင်းလဲမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	concat(string1, string2, …)
Argument များ	string - string တန်ဖိုးတစ်ခု
ဥပမာများ	concat('sun', 'set') → ‘sunset’ concat('a','b','c','d','e') → ‘abcde’ concat('Anno ', 1984) → ‘Anno 1984’ concat('The Wall', NULL) → ‘The Wall’

Field များ ပေါင်းစပ်ခြင်းအကြောင်း

|| သို့မဟုတ် + operator များကို အသုံးပြု၍ စာသားများ သို့မဟုတ် field တန်ဖိုးများကို ပေါင်းစပ်နိုင်သည်-

• + operator သည် ‌ပေါင်းခြင်း expression ကို ဆိုလိုသည်။ အကယ်၍ ကိန်းပြည့် (integer) (field သို့မဟုတ် ကိန်းဂဏန်းတန်ဖိုး) ပမာဏတစ်ခုရှိပါက error ဖြစ်နိုင်ပြီး အခြားအရာများကို အသုံးပြုလျှင်ပိုမိုကောင်းမွန်နိုင်မည်ဖြစ်သည်-:

  'My feature id is: ' + "gid" => gid သည် interger တစ်ခုပြန်ထုတ်ပေးသောကြောင့် error ဖြစ်စေပါမည်
  

• Argument တစ်ခုခုသည် Null တန်ဖိုးဖြစ်ပါက || သို့မဟုတ် + သည် Null တန်ဖိုးတစ်ခုကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။ NULL တန်ဖိုးကို ထည့်သွင်းမစဉ်းစားပဲ အခြားသော argument များ ပြန်ရရှိရန် concat function ကို အသုံးပြုနိုင်သည်-:

  'My feature id is: ' + NULL ==> NULL
  'My feature id is: ' || NULL => NULL
  concat('My feature id is: ', NULL) => 'My feature id is: '
  

ထပ်မံဖတ်ရှုရန်- || ၊ +

13.2.25.4. format

ပေးထားသည့် argument များကို အသုံးပြုပြီး string တစ်ခုကို Format (ပုံစံ) ပြုလုပ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	format(string, arg1, arg2, …)
Argument များ	string - argument များအတွက် placeholder များ (ကိန်းတစ်ခု၏ ဒဿမကိုယ်စားပြုမှုတွင် သိသာထင်ရှားသော သုည) %1၊ %2၊ အစရှိသဖြင့် ပါရှိသော string တစ်ခု။ Placeholder များကို ထပ်ဖန်တလဲလဲပြုလုပ်နိုင်ပါသည်။ အနိမ့်ဆုံးနံပါတ်တပ်ထားသည့် placeholder ကို arg1၊ နောက်တစ်ခုကို arg2 စသဖြင့် အစားထိုးပါသည်။ arg - မည်သည့်အမျိုးအစားမဆို။ argument များ၏ မည်သည့်နံပါတ်မဆို။
ဥပမာများ	format('This %1 a %2','is', 'test') → ‘This is a test’ format('This is %2','a bit unexpected but 2 is lowest number in string','normal') → ‘This is a bit unexpected but 2 is lowest number in string’

13.2.25.5. format_date

ဒေတာအမျိုးအစားတစ်ခု သို့မဟုတ် string တစ်ခုကို စိတ်ကြိုက်ရွေးချယ်ဖန်တီးထားသည့် string format(ပုံစံ) တစ်ခုအဖြစ်သို့ format ပြုလုပ်ပေးပါသည်။ Qt date/time format string များကို အသုံးပြုပါသည်။ QDateTime::toString ကို ကြည့်ရှုပါ။

Syntax (ဝါကျဖွဲ့ပုံ)	format_date(datetime, format, [language]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	datetime - ရက်စွဲ၊ အချိန် သို့မဟုတ် ရက်စွဲအချိန် တန်ဖိုး format - string ကို format ပြုလုပ်ရန် အသုံးပြုသည့် String template (နမူနာပုံစံ) Expression Output (ရလဒ်) d နေ့ရက်ကို ရှေ့မှ သုညဖြင့် မစတင်သည့် ဂဏန်းအဖြစ် (1 မှ 31 သို့) dd နေ့ရက်ကို ရှေ့မှ သုညဖြင့် စတင်သည့် ဂဏန်းအဖြစ် (01 မှ 31 သို့) ddd အတိုချုပ်ထားသည့် နေ့အမည် (ဥပမာ ‘Mon’ မှ ‘Sun’) dddd နေ့အမည် အပြည့်အစုံ (ဥပမာ ‘Monday’ မှ ‘Sunday’) M လကို ရှေ့မှ သုညဖြင့် မစတင်သည့် ဂဏန်းအဖြစ် (1-12) MM လကို ရှေ့မှ သုညဖြင့် စတင်သည့် ဂဏန်းအဖြစ် ဂဏန်းအဖြစ် (01-12) MMM အတိုချုပ်ထားသည့် လအမည် (ဥပမာ ‘Jan’ မှ ‘Dec’) MMMM လအမည်အပြည့်အစုံ (ဥပမာ ‘January’ မှ ‘December’) yy ဒစ်ဂျယ်ဂဏန်း နှစ်လုံးအဖြစ် ခုနှစ် (00-99) yyyy ဒစ်ဂျယ်ဂဏန်း လေးလုံးအဖြစ် ခုနှစ် ဤ expression များကို format string ၏ အချိန်အစိတ်အပိုင်းအဖြစ် အသုံးပြုနိုင်ပါသည်- Expression Output (ရလဒ်) h ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (0 မှ 23 သို့မဟုတ် အကယ်၍ AM/PM ပြသမှုဖြစ်ပါက 1 မှ 12) hh ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (00 မှ 23 သို့မဟုတ် အကယ်၍ AM/PM ပြသမှုဖြစ်ပါက 01 မှ 12) H ရှေ့မှ သုညဖြင့် မစတင်သည့် နာရီ (0 မှ 23 ၊ AM/PM ပြသမှု ဖြစ်စေကာမူ) HH ရှေ့မှ သုညဖြင့် စတင်သည့် နာရီ (00 မှ 23 ၊ AM/PM ပြသမှု ဖြစ်စေကာမူ) m ရှေ့မှ သုညဖြင့် မစတင်သည့် မိနစ် (0 မှ 59) mm ရှေ့မှ သုညဖြင့် စတင်သည့် မိနစ် (00 မှ 59) s ရှေ့မှ သုညဖြင့် မစတင်သည့် စက္ကန့် (0 မှ 59) ss ရှေ့မှ သုညဖြင့် စတင်သည့် စက္ကန့် (00 မှ 59) z trailing zeroes (ဒဿမနောက်ရှိ သုည) များ မပါရှိသည့် မီလီစက္ကန့်များ (0 မှ 999) zzz trailing zeroes (ဒဿမနောက်ရှိ သုည) များ ပါရှိသည့် မီလီစက္ကန့်များ (000 မှ 999) AP သို့မဟုတ် A AM/PM အချိန်တစ်ခုအဖြစ် ပြန်ဆိုပါသည်။ AP သည်’AM’ သို့မဟုတ် ‘PM’ တစ်ခုမဟုတ်တစ်ခု ဖြစ်ရပါမည် ap သို့မဟုတ် a AM/PM အချိန်တစ်ခုအဖြစ် ပြန်ဆိုပါသည်။ ap သည် ‘am’ သို့မဟုတ် ‘pm’ တစ်ခုမဟုတ်တစ်ခု ဖြစ်ရပါမည် language - ရက်စွဲကို စိတ်ကြိုက်ရွေးချယ်ထားသည့် string တစ်ခုအဖြစ်သို့ format ပြုလုပ်ရန် ဘာသာစကား (lowercase(စာလုံးအသေး) ၊ two- or three-letter၊ ISO 639 language code) ။ Default အားဖြင့် လက်ရှိ QGIS user locale (အသုံးပြုသူ၏နေရာဒေသ) ကို အသုံးပြုပါသည်။
ဥပမာများ	format_date('2012-05-15','dd.MM.yyyy') → ‘15.05.2012’ format_date('2012-05-15','d MMMM yyyy','fr') → ‘15 mai 2012’ format_date('2012-05-15','dddd') → အကယ်၍ လက်ရှိ locale သည် English မူကွဲ (variant) တစ်ခုဖြစ်ပါက ‘Tuesday’ ပြန်ထုတ်ပေးပါမည် format_date('2012-05-15 13:54:20','dd.MM.yy') → ‘15.05.12’ format_date('13:54:20','hh:mm AP') → ‘01:54 PM’

13.2.25.6. format_number

ထောင်ဂဏန်းများအတွက် locale separator ဖြင့် format ပြုလုပ်ထားသည့် ကိန်းဂဏန်းတစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ Default အားဖြင့် လက်ရှိ QGIS user locale ကို အသုံးပြုပါသည်။ ဒဿမနေရာများကို ပံ့ပိုးပေးထားသော နေရာအရေအတွက်တွင်လည်း ဖြတ်တောက်ပေး (truncates) သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	format_number(number, [places=0], [language], [omit_group_separators=false], [trim_trailing_zeroes=false]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	number - format ပြုလုပ်ရန် ကိန်းဂဏန်း places - string ကို ဖြတ်တောက်ရန် ဒဿမနေရာများကို ကိုယ်စားပြုဖော်ပြသည့် ကိန်းပြည့် language - ကိန်းဂဏန်းကို string တစ်ခုအဖြစ်သို့ format ပြုလုပ်ရန် အသုံးပြုသည့် ဘာသာစကား (စာလုံးအသေး၊ two- or three-letter၊ ISO 639 language code )။ Default အားဖြင့် လက်ရှိ QGIS user locale ကို အသုံးပြုပါသည်။ omit_group_separators - အကယ်၍ true သို့ သတ်မှတ်ပါက group separator များသည် string ထဲတွင် ပါဝင်လိမ့်မည်မဟုတ်ပါ။ trim_trailing_zeroes - အကယ်၍ true သို့ သတ်မှတ်ပါက ဒဿမပွိုင့်များနောက်ရှိ “trailing zeroes (ဒဿမနောက်ရှိ သုည) များသည် string မှ ဖြတ်ထုတ်ခြင်းခံရမည်ဖြစ်ပါသည်။
ဥပမာများ	format_number(10000000.332,2) → အကယ်၍ ဥပမာ လက်ရှိ locale သည် အင်္ဂလိပ်မူကွဲ (English variant) တစ်ခုဖြစ်ပါက ‘10,000,000.33’ ဟုပြန်ထုတ်ပေးမည်ဖြစ်သည် format_number(10000000.332,2,'fr') → ‘10 000 000,33’

13.2.25.7. left

String ၏ ဘယ်ဘက်အစွန်ဆုံး (leftmost) n အကြိမ်ရေမြောက် character များပါဝင်သော string အခွဲ တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	left(string, length)
Argument များ	string - string တစ်ခု length - ကိန်းပြည့်။ ပြန်ထုတ်ပေးရန် string ၏ ဘယ်ဘက်မှ character အရေအတွက်
ဥပမာများ	left('Hello World',5) → ‘Hello’

13.2.25.8. length

ဂျီဩမေတြီ linestring တစ်ခု၏ အလျား သို့မဟုတ် string တစ်ခုထဲရှိ character အရေအတွက်ကို ပြန်ထုတ်ပေးပါသည်။

String variant (စာသားမူကွဲ)

String တစ်ခုထဲရှိ character အရေအတွက် ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	length(string)
Argument များ	string - အလျားကို ရေတွက်ရန် string
ဥပမာများ	length('hello') → 5

Geometry variant (ဂျီဩမေတြီမူကွဲ)

ဂျီဩမေတြီ line object တစ်ခု၏ အလျားကို တွက်ချက်ပေးပါသည်။ တွက်ချက်မှုများသည် ဤ ဂျီဩမေတြီ၏ Spatial Reference System (SRS) ထဲတွင် အမြဲတမ်း Planimetrics (Planimetrics သည် ထောင့်များ၊ အကွာအဝေး နှင့် ဧရိယာများ အပါအဝင် ပြင်ညီအတိုင်းအတာများကို လေ့လာခြင်းဖြစ်သည်) ဖြစ်ပြီး ရရှိလာသည့် အလျား၏ ယူနစ်များသည် SRS အတွက် ယူနစ်များနှင့် ကိုက်ညီမည်ဖြစ်ပါသည်။ ၎င်းသည် $length function ဖြင့် ဆောင်ရွက်သည့် တွက်ချက်မှုနှင့် မတူကွဲပြားပါသည်။ အဆိုပါ function သည် project ၏ အီလစ်ဆွိုက် (ellipsoid) နှင့် အကွာအဝေးယူနစ် setting များအပေါ်တွင် အခြေခံပြီး အီလစ်ဆွိုက် (ellipsoid) ဆိုင်ရာ တွက်ချက်မှုကို ဆောင်ရွက်မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	length(geometry)
Argument များ	geometry - line ဂျီဩမေတြီ object
ဥပမာများ	length(geom_from_wkt('LINESTRING(0 0, 4 0)')) → 4.0

13.2.25.9. lower

String တစ်ခုကို စာလုံးအသေးများ (lower case letters) အဖြစ်သို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	lower(string)
Argument များ	string - စာလုံးအသေးများ (lower case letters) သို့ ပြောင်းလဲရန် string
ဥပမာများ	lower('HELLO World') → ‘hello world’

13.2.25.10. lpad

အဖြည့် (fill) character တစ်ခုကို အသုံးပြုပြီး သတ်မှတ်ထားသော အကျယ် (width) အတိုင်း ဘယ်ဘက်တွင် ဖြည့်ထား (padded) သော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ရည်မှန်းထားသည့် အကျယ်သည် string ၏ အလျားအောက်ငယ်ပါက string ကို ဖြတ်ထုတ် (truncate) မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	lpad(string, width, fill)
Argument များ	string - pad (ဖြည့်ခြင်း) ပြုလုပ်ရန် string width - string အသစ်၏ အလျား fill - ကျန် နေရာလွတ်ကို pad (ဖြည့်ခြင်း) ပြုလုပ်ရန် character
ဥပမာများ	lpad('Hello', 10, 'x') → ‘xxxxxHello’ lpad('Hello', 3, 'x') → ‘Hel’

13.2.25.11. ltrim

String ၏ အစမှ သတ်မှတ်ထားသော character များ (default အားဖြင့် space တစ်ခု) သာပါဝင်သော အရှည်ဆုံး string ကို ဖယ်ရှားပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	ltrim(string, [characters=’ ‘]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ဖြတ်ထုတ်ရန် string characters - ဖြတ်ထုတ်ရန် character များ
ဥပမာများ	ltrim('   hello world  ') → ‘hello world ‘ ltrim('zzzytest', 'xyz') → ‘test’

ထပ်မံဖတ်ရှုရန်- rtrim ၊ trim

13.2.25.12. regexp_match

Unicode string တစ်ခုအတွင်း regular expression တစ်ခုနှင့်ကိုက်ညီမှုရှိသော ပထမဆုံးကိုက်ညီသည့် တည်နေရာကို ပြန်ထုတ်ပေးပါသည်၊ သို့မဟုတ် အကယ်၍ string အခွဲကို ရှာမတွေ့ပါက 0 ကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	regexp_match(input_string, regex)
Argument များ	input_string - regular expression အတိုင်း စမ်းသပ်ရန် string regex - စမ်းသပ်ရန် regular expression ။ Backslash () character များသည် double escape ဖြစ်ရမည်ဖြစ်ပါသည်။ (ဥပမာ- white space character တစ်ခုနှင့် ကိုက်ညီရန် “\\s” သို့မဟုတ် word boundary (စာလုံးနယ်နိမိတ်) တစ်ခုနှင့် ကိုက်ညီရန် “\\b” )
ဥပမာများ	regexp_match('QGIS ROCKS','\\sROCKS') → 5 regexp_match('Budač','udač\\b') → 2

13.2.25.13. regexp_replace

ပံ့ပိုးပေးထားသော regular expression ဖြင့် အစားထိုးထားသည့် string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	regexp_replace(input_string, regex, replacement)
Argument များ	input_string - ကိုက်ညီမှုများကို အစားထိုးရန် string regex - အစားထိုးရန် regular expression ။ Backslash () character များသည် double escape ဖြစ်ရမည်ဖြစ်ပါသည်။ (ဥပမာ- white space character တစ်ခုနှင့် ကိုက်ညီရန် “\\s”) replacement - ပံ့ပိုးပေးထားသော regular expression ၏ ကိုက်ညီမှုရှိသော မည်သည့် ဖြစ်ပွားမှု (occurrences) များကိုမဆို အစားထိုးမည့် string ။ Captured group (Capturing group များသည် characters များစွာကို single unit တစ်ခုတည်းအဖြစ် ပြုမှုဆက်ဆံရန် နည်းလမ်းဖြစ်ပါသည်) များကို \\1 ၊ \\2 စသည်တို့ကို အသုံးပြုပြီး replacement string ထဲသို့ ထည့်သွင်းနိုင်ပါသည်။
ဥပမာများ	regexp_replace('QGIS SHOULD ROCK','\\sSHOULD\\s',' DOES ') → ‘QGIS DOES ROCK’ regexp_replace('ABC123','\\d+','') → ‘ABC’ regexp_replace('my name is John','(.*) is (.*)','\\2 is \\1') → ‘John is my name’

13.2.25.14. regexp_substr

ပံ့ပိုးပေးထားသည့် regular expression တစ်ခုနှင့် ကိုက်ညီမှုရှိသော string တစ်ခု၏ တစ်စိတ်တစ်ပိုင်းကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	regexp_substr(input_string, regex)
Argument များ	input_string - ကိုက်ညီမှုများကိုရှာဖွေရန် string regex - ကိုက်ညီမှုအတွက် regular expression ။ Backslash () character များသည် double escape ဖြစ်ရမည်ဖြစ်ပါသည်။ (ဥပမာ- white space character တစ်ခုနှင့် ကိုက်ညီရန် “\\s”)
ဥပမာများ	regexp_substr('abc123','(\\d+)') → ‘123’

13.2.25.15. replace

ပံ့ပိုးပေးထားသည့် string ၊ array သို့မဟုတ် အစားထိုးထားသည့် string များ၏ map ပါရှိသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

String & array variant (စာသားနှင့် array မူကွဲ)

ပံ့ပိုးပေးထားသည့် string သို့မဟုတ် string တစ်ခု သို့မဟုတ် string များ၏ array တစ်ခုဖြင့် အစားထိုးထားသော string များ၏ array ပါရှိသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	replace(string, before, after)
Argument များ	string - ထည့်သွင်းအသုံးပြုသော string before - အစားထိုးရန် string သို့မဟုတ် string များ၏ array after - အစားထိုးမှုတစ်ခုအဖြစ်အသုံးပြုရန် string သို့မဟုတ် string များ၏ array
ဥပမာများ	replace('QGIS SHOULD ROCK','SHOULD','DOES') → ‘QGIS DOES ROCK’ replace('QGIS ABC',array('A','B','C'),array('X','Y','Z')) → ‘QGIS XYZ’ replace('QGIS',array('Q','S'),'') → ‘GI’

Map variant (ပုံဖော်မှု မူကွဲ)

တန်ဖိုးအတွဲများ (paired values) ဖြင့် အစားထိုးထားသော ပံ့ပိုးပေးထားသည့် map key များပါရှိသည့် string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ ရှည်လျားသည့် map key များကို ဦးစွာ သုံးသပ်မည်ဖြစ်ပါသည်။

Syntax	replace(string, map)
Argument များ	string - ထည့်သွင်းအသုံးပြုသော string map - key များနှင့် တန်ဖိုးများပါဝင်သော map
ဥပမာများ	replace('APP SHOULD ROCK',map('APP','QGIS','SHOULD','DOES')) → ‘QGIS DOES ROCK’ replace('forty two',map('for','4','two','2','forty two','42')) → ‘42’

13.2.25.16. right

String ၏ ညာဘက်အစွန်ဆုံး (rightmost) n အကြိမ်ရေမြောက် character များပါဝင်သော string အခွဲ တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	right(string, length)
Argument များ	string - string တစ်ခု length - ကိန်းပြည့်။ string ၏ ညာဘက်မှ ပြန်ထုတ်ပေးမည့် character အရေအတွက်
ဥပမာများ	right('Hello World',5) → ‘World’

13.2.25.17. rpad

အဖြည့် (fill) character တစ်ခုကို အသုံးပြုပြီး သတ်မှတ်ထားသော အကျယ် (width) အတိုင်း ညာဘက်တွင် ဖြည့်ထား (padded) သော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည်။ အကယ်၍ ရည်မှန်းထားသည့် အကျယ်သည် string ၏ အလျားအောက်ငယ်ပါက string ကို ဖြတ်ထုတ် (truncate) မည်ဖြစ်ပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	rpad(string, width, fill)
Argument များ	string - pad (ဖြည့်ခြင်း) ပြုလုပ်ရန် string width - string အသစ်၏ အလျား fill - ကျန် နေရာလွတ်ကို pad (ဖြည့်ခြင်း) ပြုလုပ်ရန် character
ဥပမာများ	rpad('Hello', 10, 'x') → ‘Helloxxxxx’ rpad('Hello', 3, 'x') → ‘Hel’

13.2.25.18. rtrim

String ၏ အဆုံးမှ သတ်မှတ်ထားသော character များ (default အားဖြင့် space တစ်ခု) သာပါဝင်သော အရှည်ဆုံး string ကို ဖယ်ရှားပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	rtrim(string, [characters=’ ‘]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ဖြတ်ထုတ်ရန် string characters - ဖြတ်ထုတ်ရန် character များ
ဥပမာများ	rtrim('   hello world  ') → ‘ hello world’ rtrim('testxxzx', 'xyz') → ‘test’

ထပ်မံဖတ်ရှုရန်- ltrim ၊ trim

13.2.25.19. strpos

အခြား string တစ်ခုအတွင်းရှိ string အခွဲတစ်ခု၏ ပထမဆုံးကိုက်ညီမှုရှိသည့် တည်နေရာ ပြန်ထုတ်ပေးပါသည်။ သို့မဟုတ် အကယ်၍ string အခွဲကို မတွေ့ရှိခဲ့ပါက 0 ကို ပြန်ထုတ်ပေးမည်ဖြစ်သည်။

Syntax (ဝါကျဖွဲ့ပုံ)	strpos(haystack, needle)
Argument များ	haystack - ရှာဖွေရမည့် string needle - ရှာဖွေမှုပြုလုပ်ရမည့် string
ဥပမာများ	strpos('HELLO WORLD','WORLD') → 7 strpos('HELLO WORLD','GOODBYE') → 0

13.2.25.20. substr

String တစ်ခု၏ အပိုင်းတစ်ပိုင်းကို ပြန်ထုတ်ပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	substr(string, start, [length]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - ထည့်သွင်းအသုံးပြုသော string အပြည့်အစုံ start - 1 ဖြင့် အစပြုမှုကို ထုတ်ယူ (extract) ရန် စမှတ်နေရာ (start position) ကို ကိုယ်စားပြုဖော်ပြသည့် ကိန်းပြည့်၊ အကယ်၍ အစ (start) သည် အနုတ်ဖြစ်ပါက ပြန်လည်ရရှိလာမည့် string သည် string ၏အဆုံးမှ အစတန်ဖိုးကို နုတ်ထားသည့်နေရာတွင် အစပြုမည်ဖြစ်ပါသည်။ * length - ထုတ်ယူ (extract) ရန် string ၏ အလျားကို ကိုယ်စားပြုဖော်ပြသည့် ကိန်းပြည့်၊ အကယ်၍ အလျားသည် အနုတ်ဖြစ်ပါက ပြန်လည်ရရှိလာမည့် string သည် string ၏ အဆုံးမှ ပေးထားသည့် character များ၏ အလျားကို ချန်လှပ် (omit) ထားမည်ဖြစ်ပါသည်။
ဥပမာများ	substr('HELLO WORLD',3,5) → ‘LLO W’ substr('HELLO WORLD',6) → ‘ WORLD’ substr('HELLO WORLD',-5) → ‘WORLD’ substr('HELLO',3,-1) → ‘LL’ substr('HELLO WORLD',-5,2) → ‘WO’ substr('HELLO WORLD',-5,-1) → ‘WORL’

13.2.25.21. title

String တစ်ခု၏ စကားလုံးများအားလုံးကို title case (ရှေ့စကားလုံးများကို အကြီးစာလုံးဖြင့် ရေးသားထားပြီး ကျန်စကားလုံးများကို အသေးစာလုံးများအားလုံး) အဖြစ်သို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	title(string)
Argument များ	string - title case အဖြစ်သို့ ပြောင်းလဲရန် string
ဥပမာများ	title('hello WOrld') → ‘Hello World’

13.2.25.22. to_string

ကိန်းဂဏန်း တစ်ခုကို string အဖြစ်သို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	to_string(number)
Argument များ	number - ကိန်းပြည့် သို့မဟုတ် ကိန်းစစ် တန်ဖိုး။ string အဖြစ်သို့ ပြောင်းလဲရန် ကိန်းဂဏန်း
ဥပမာများ	to_string(123) → ‘123’

13.2.25.23. trim

String တစ်ခုမှ ရှေ့ (leading) သို့မဟုတ် နောက် (trailing) ရှိ whitespace အားလုံး (spaces၊ tabs၊ အစရှိသည်) ကို ဖယ်ရှားပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	trim(string)
Argument များ	string - ဖြတ်ထုတ်ရန် (trim) string
ဥပမာများ	trim('   hello world  ') → ‘hello world’

ထပ်မံဖတ်ရှုရန်- ltrim ၊ rtrim

13.2.25.24. upper

String တစ်ခုကို စာလုံးအကြီးများ (upper case letters) အဖြစ်သို့ ပြောင်းလဲပေးပါသည်။

Syntax (ဝါကျဖွဲ့ပုံ)	upper(string)
Argument များ	string - စာလုံးအကြီးများ (upper case letters) အဖြစ်သို့ ပြောင်းလဲရန် string
ဥပမာများ	upper('hello WOrld') → ‘HELLO WORLD’

13.2.25.25. wordwrap

Character များ၏ အများဆုံး/အနည်းဆုံး အရေအတွက်သို့ wrap လုပ်ထားသော string တစ်ခုကို ပြန်ထုတ်ပေးပါသည် (wrap သည် သတ်မှတ်ထားသော အရှည်သို့ရောက်သောအခါ string တစ်ခုကို စာကြောင်းအသစ်များအဖြစ်သို့ ဖြစ်စေပါသည်)။

Syntax (ဝါကျဖွဲ့ပုံ)	wordwrap(string, wrap_length, [delimiter_string]) [] သည် optional (မဖြစ်မနေလုပ်ဆောင်ရန်မလိုသော) argument များဖြစ်ပါသည်
Argument များ	string - wrapped ပြုလုပ်ရန် string wrap_length - ကိန်းပြည့်တစ်ခု။ အကယ်၍ wrap_length သည် အပေါင်းဖြစ်ပါက ကိန်းဂဏန်းသည် wrap ပြုလုပ်ရန် character များ၏ အများဆုံးစံအရေအတွက်ကို ကိုယ်စားပြုဖော်ပြပါသည်။ အကယ်၍ wrap_length သည် အနုတ်ဖြစ်ပါက ကိန်းဂဏန်းသည် wrap ပြုလုပ်ရန် character များ၏ အနည်းဆုံးအရေအတွက်ကို ကိုယ်စားပြုဖော်ပြပါသည်။ delimiter_string - စာကြောင်းအသစ်တစ်ခုသို့ wrap ပြုလုပ်ရန် စိတ်ကြိုက်ရွေးချယ်နိုင်သည့် delimiter string (string တစ်ခုကို ပိုင်းခြားရန် အသုံးပြုနိုင်သည့် characters များ)
ဥပမာများ	wordwrap('UNIVERSITY OF QGIS',13) → ‘UNIVERSITY OF<br>QGIS’ wordwrap('UNIVERSITY OF QGIS',-3) → ‘UNIVERSITY<br>OF QGIS’

13.2.26. ကိုယ်ပိုင် Expression များ (User Expressions)

ဤအုပ်စုတွင် user expression များ အဖြစ် သိမ်းဆည်းထားသော expression များ ပါဝင်ပါသည်။

13.2.27. ကိန်းရှင်များ (Variables)

ဤအုပ်စုတွင် application၊ project file နှင့် အခြား setting များနှင့် သက်ဆိုင်သည့် ပြောင်းလဲနိုင်သော variable များ ပါဝင်ပါသည်။ Variable များရရှိနိုင်မှုသည် အကြောင်းအရာများအပေါ် မူတည်သည်-

• ^{Select by expression} (Expression ဖြင့် ရွေးခြယ်ခြင်း) dialog မှ

• ^{Field calculator} dialog မှ

• Layer properties dialog မှ

• Print layout မှ

ဤ variable များကို expression တစ်ခုတွင် အသုံးပြုလိုလျှင် @ အက္ခရာကို ရှေ့တွင်ထားပြီး အသုံးပြုသင့်သည် (ဥပမာ- @row_number)။

Variable (ကိန်းရှင်)	ဖော်ပြချက်
algorithm_id	Algorithm တစ်ခု၏ ထူးခြားသော ID
animation_end_time	Animation (လှုပ်ရှားရုပ်ပုံပြသခြင်း) ၏ အချိန်အပိုင်းအခြား အဆုံးသတ် (Datetime တန်ဖိုးတစ်ခုအဖြစ်)
animation_interval	Animation ၏ အချိန်အပိုင်းအခြား ကြာချိန် (Interval တန်ဖိုးတစ်ခုအဖြစ်)
animation_start_time	Animation ၏ အချိန်အပိုင်းအခြား အစ (Datetime တန်ဖိုးတစ်ခုအဖြစ်)
atlas_feature	လက်ရှိ atlas feature (Feature object အဖြစ်)
atlas_featureid	လက်ရှိ atlas feature ID
atlas_featurenumber	Layout ထဲရှိ လက်ရှိ atlas feature နံပါတ်
atlas_filename	လက်ရှိ atlas feature ဖိုင် အမည်
atlas_geometry	လက်ရှိ atlas feature ဂျီသြမေတြီ
atlas_layerid	လက်ရှိ atlas လွှမ်းခြုံသော layer ID
atlas_layername	လက်ရှိ atlas လွှမ်းခြုံသော layer အမည်
atlas_pagename	လက်ရှိ atlas စာမျက်နှာ (page) အမည်
atlas_totalfeatures	Atlas ရှိ စုစုပေါင်း feature များ အရေအတွက်
canvas_cursor_point	Project ၏ ပထဝီဝင်ဆိုင်ရာ ကိုသြဒိနိတ်များဖြင့် canvas ပေါ်ရှိ နောက်ဆုံး cursor တည်နေရာ
cluster_color	Cluster (အစုအဖွဲ့) တစ်ခုအတွင်းမှာရှိသည့် သင်္ကေတများ၏ အရောင် သို့မဟုတ် သင်္ကေတများသည် အရောင်ရောနှောနေလျှင် NULL
cluster_size	Cluster တစ်ခုအတွင်း ပါဝင်သည့် သင်္ကေတများအရေအတွက်
current_feature	Attribute form သို့မဟုတ် ဇယား row တွင် လက်ရှိ တည်းဖြတ်နေသည့် feature
current_geometry	Attribute form သို့မဟုတ် ဇယား row တွင် လက်ရှိ တည်းဖြတ်နေသည့် feature ၏ ဂျီသြမေတြီ
current_parent_feature	Parent attribute form တွင် လက်ရှိတည်းဖြတ်နေသည့် feature ကို ကိုယ်စားပြုသည်။ ထည့်သွင်းထားသော form အကြောင်းအရာတွင်သာ အသုံးပြုနိုင်သည်။
current_parent_geometry	Parent attribute form တွင် လက်ရှိတည်းဖြတ်နေသည့် feature ၏ ဂျီသြမေတြီကို ကိုယ်စားပြုသည်။ ထည့်သွင်းထားသော form အကြောင်းအရာတွင်သာ အသုံးပြုနိုင်သည်။
form_mode	Form ကို မည်သည့်အတွက် အသုံးပြုမည်၊ ဥပမာ- AddFeatureMode ၊ SingleEditMode ၊ MultiEditMode ၊ SearchMode ၊ AggregateSearchMode သို့မဟုတ် string အနေဖြင့် IdentifyMode
feature	လက်ရှိ အကဲဖြတ်ဆန်းစစ်ခံနေရသည့် feature ။ ဤအရာသည် လက်ရှိ feature မှ attribute တန်ဖိုးများကို အကဲဖြတ်ဆန်းစစ်ရန် ‘attribute’ function ဖြင့် အသုံးပြုနိုင်ပါသည်။
frame_duration	Animation ဘောင် (frame) တစ်ခုစီ၏ ကြာချိန်ကာလ (Interval တန်ဖိုးတစ်ခုအဖြစ်)
frame_number	Animation ပြသနေချိန်တွင် လက်ရှိ frame နံပါတ်
frame_rate	Animation ပြသနေချိန်တွင် တစ်စက္ကန့်ရှိ frame အရေအတွက် (Number of frames per second)
fullextent_maxx	Canvas extent အပြည့် မှ အမြင့်ဆုံး x တန်ဖိုး (Layer များအားလုံး အပါအဝင်)
fullextent_maxy	Canvas extent အပြည့် မှ အမြင့်ဆုံး y တန်ဖိုး (layer များအားလုံး အပါအဝင်)
fullextent_minx	Canvas extent အပြည့် မှ အနိမ့်ဆုံး x တန်ဖိုး (layer များအားလုံး အပါအဝင်)
fullextent_miny	Canvas extent အပြည့် မှ အနိမ့်ဆုံး y တန်ဖိုး (layer များအားလုံး အပါအဝင်)
geometry	လက်ရှိ အကဲဖြတ်ဆန်းစစ်ခြင်းခံနေရသည့် feature ၏ ဂျီသြမေတြီ
geometry_part_count	ပုံဖော်ပြသထားသော feature ၏ ဂျီသြမေတြီရှိ အစိတ်အပိုင်းများအရေအတွက်
geometry_part_num	ပုံဖော်ပြသထားသော feature အတွက် လက်ရှိဂျီသြမေတြီ အစိတ်အပိုင်း နံပါတ်
geometry_point_count	ပုံဖော်ပြသထားသော ဂျီသြမေတြီ ၏ အစိတ်အပိုင်းရှိ point များ အရေအတွက်
geometry_point_num	ပုံဖော်ပြသထားသော ဂျီသြမေတြီ ၏ အစိတ်အပိုင်းရှိ လက်ရှိ point နံပါတ်
geometry_ring_num	ပုံဖော်ပြသထားသော feature ၏ လက်ရှိ ဂျီသြမေတြီ ring (ကွင်း) နံပါတ် (polygon feature များအတွက်သာ)။ အပြင် ring သည် 0 တန်ဖိုးတစ်ခု ရှိပါသည်။
grid_axis	လက်ရှိ grid annotation ဝင်ရိုး (ဥပမာ- လောင်ဂျီကျူအတွက် ‘x’၊ လတ္တီကျူအတွက် ‘y’)
grid_number	လက်ရှိ grid annotation တန်ဖိုး
id	လက်ရှိ အကဲဖြတ်ဆန်းစစ်ခြင်းခံနေရသည့် feature ၏ id
item_id	Layout item အသုံးပြုသူ ID (Unique ဖြစ်ရန်မလိုအပ်ပါ)
item_uuid	Layout item ထူးခြားသည့် ID
layer	လက်ရှိ layer
layer_crs	လက်ရှိ layer ၏ Coordinate Reference System Authority ID
layer_id	လက်ရှိ layer ၏ ID
layer_ids	စာရင်းတစ်ခုအနေဖြင့် လက်ရှိ project ရှိ မြေပုံ layer အားလုံး၏ ID များ
layer_name	လက်ရှိ layer ၏ အမည်
layers	စာရင်းတစ်ခုအနေဖြင့် လက်ရှိ project ရှိ မြေပုံ layer များအားလုံး
layout_dpi	ဖွဲ့စည်းမှု ပြတ်သားကြည်လင်မှု (resolution) (DPI)
layout_name	Layout အမည်
layout_numpages	Layout ရှိ စာမျက်နှာ အရေအတွက်
layout_page	Layout ထဲရှိ လက်ရှိ item ၏ စာမျက်နှာအရေအတွက်
layout_pageheight	Layout ရှိ active ဖြစ်နေသော စာမျက်နှာ၏ အမြင့် (စံနမူနာ စာရွက် အရွယ်အစားများအတွက် မီလီမီတာ ဖြင့်၊ သို့မဟုတ် စိတ်ကြိုက် စာရွက် အရွယ်အစားအတွက် မည်သည့် ယူနစ်ကိုမဆို အသုံးပြုနိုင်သည်)
layout_pageoffsets	စာမျက်နှာ တစ်ခုစီ၏ ထိပ်ရှိ Y ကိုသြဒိနိတ် Array။ စာမျက်နှာအရွယ်အစားများ ပြောင်းလဲနိုင်သည့် အခြေအနေတွင် စာမျက်နှာများပေါ်ရှိ item များကို ပြောင်းလဲနေရာချထားနိုင်သည်။
layout_pagewidth	Layout ရှိ active ဖြစ်နေသော စာမျက်နှာ၏ အနံ (စံနမူနာ စာရွက် အရွယ်အစားများအတွက် မီလီမီတာ ဖြင့်၊ သို့မဟုတ် စိတ်ကြိုက် စာရွက် အရွယ်အစားအတွက် မည်သည့် ယူနစ်ကိုမဆို အသုံးပြုနိုင်သည်
legend_column_count	Legend (မြေပုံရည်ညွှန်းချက်) ရှိ column များအရေအတွက်
legend_filter_by_map	Legend ၏ အကြောင်းအရာများကို မြေပုံဖြင့် စစ်ထုတ် (filter) လျှင် ညွှန်ပြပေးသည်။
legend_filter_out_atlas	Atlas ကို legend ထဲမှ စစ်ထုတ် (filter) သည့်အခါ ညွှန်ပြပေးသည်။
legend_split_layers	Legend ထဲတွင် layer များကို ခွဲထုတ်လိုသည့်အခါ ညွှန်ပြပေးသည်။
legend_title	Legend ၏ ခေါင်းစဥ်
legend_wrap_string	Legend စာသားများကို ခြုံငုံစေရန် အသုံးပြုသည့် စကားလုံး(များ)
map_crs	လက်ရှိ မြေပုံ၏ CRS (ရည်ညွှန်းကိုသြဒိနိတ်စနစ်)
map_crs_acronym	လက်ရှိမြေပုံ CRS ၏ အတိုကောက်
map_crs_definition	လက်ရှိမြေပုံ CRS ၏ အပြည့်အစုံ အဓိပ္ပါယ်ဖွင့်ဆိုချက်
map_crs_description	လက်ရှိမြေပုံ CRS ၏ အမည်
map_crs_ellipsoid	လက်ရှိမြေပုံ CRS ၏ ဘဲဥပုံစက်ဝိုင်း (ellipsoid) အတိုကောက်
map_crs_proj4	လက်ရှိမြေပုံ CRS ၏ proj4 အဓိပ္ပါယ်ဖွင့်ဆိုချက်
map_crs_projection	မြေပုံ CRS မှ အသုံးပြုသည့် projection နည်းလမ်း၏ ဖော်ပြချက်အမည် (ဥပမာ- ‘Albers Equal Area’)
map_crs_wkt	လက်ရှိမြေပုံ CRS ၏ WKT အဓိပ္ပါယ်ဖွင့်ဆိုချက်
map_end_time	မြေပုံ အချိန်အပိုင်းအခြား အဆုံး (Datetime တန်ဖိုးတစ်ခုအဖြစ်)
map_extent	မြေပုံ၏ လက်ရှိ extent ကို ကိုယ်စားပြုသည့် ဂျီသြမေတြီ
map_extent_center	မြေပုံ၏ အလယ်ဗဟိုရှိ point feature
map_extent_height	မြေပုံ၏ လက်ရှိ အမြင့်
map_extent_width	မြေပုံ၏ လက်ရှိ အနံ
map_id	လက်ရှိ မြေပုံ ဦးတည်ရာ (destination) ၏ ID။ ဤအရာသည် canvas render များအတွက် ‘canvas’ ဖြစ်ပြီး layout map render များအတွက် item ID ဖြစ်ပါသည်
map_interval	မြေပုံ၏ အချိန်အပိုင်းအခြား ကြာချိန် (Interval တန်ဖိုးတစ်ခုအဖြစ်)
map_layer_ids	မြေပုံတွင် မြင်နိုင်သော မြေပုံ layer ID များစာရင်း
map_layers	မြေပုံတွင် မြင်နိုင်သော မြေပုံ layer များစာရင်း
map_rotation	မြေပုံ လက်ရှိ အလှည့် (rotation)
map_scale	မြေပုံ၏ လက်ရှိ စကေး
map_start_time	မြေပုံ၏ အချိန်အပိုင်းအခြား အစ (Datetime တန်ဖိုးတစ်ခုအဖြစ်)
map_units	မြေပုံတိုင်းတာမှုများ၏ ယူနစ်များ
model_path	လက်ရှိ model ၏ လမ်းကြောင်းအပြည့်အစုံ (file အမည် အပါအဝင်) (သို့မဟုတ် model သည် project တစ်ခုတွင် ထည့်သွင်းထားလျှင် project လမ်းကြောင်း)။
model_folder	လက်ရှိ model ပါဝင်သည့် Folder (သို့မဟုတ် model သည် project တစ်ခုတွင် ထည့်သွင်းထားလျှင် project folder)။
model_name	လက်ရှိ model ၏ အမည်
model_group	လက်ရှိ model အတွက် အုပ်စု
notification_message	ပံ့ပိုးပေးသူမှ ပေးပို့သော အကြောင်းကြားစာ၏ အကြောင်းအရာ (ပံ့ပိုးပေးသူ၏ အကြောင်းကြားချက်များမှ အစပြုသည့် လုပ်ဆောင်ချက်များအတွက်သာ ရနိုင်ပါသည်)။
parent	မူလ layer ရှိ လက်ရှိ feature ကို ကိုယ်စားပြုသည်၊ aggregate function တစ်ခုကို စစ်ထုတ် (filter) သည့်အခါ ၎င်း၏ attribute များနှင့် ဂျီသြမေတြီများသို့ ဝင်ရောက်ခွင့်ပေးသည်။
project_abstract	Project အကျဥ်းချုပ်ကို project metadata မှ ရယူပါသည်။
project_area_units	လက်ရှိ project အတွက် ဧရိယာယူနစ်သည် ဂျီသြမေတြီများ၏ ဧရိယာများကို တွက်ချက်ရာတွင် အသုံးပြုသည်။
project_author	Project author ကို project metadata မှ ရယူပါသည်။
project_basename	လက်ရှိ project ဖိုင်အမည်၏ အခြေခံအမည် (path နှင့် extension မပါဝင်သော)
project_creation_date	Project ဖန်တီးမှု ရက်စွဲကို project metadata မှ ရယူပါသည်။
project_crs	Project ၏ CRS
project_crs_arconym	Project ၏ CRS အတိုကောက်
project_crs_definition	Project ၏ CRS အဓိပ္ပါယ်ဖွင့်ဆိုချက်အပြည့်အစုံ
project_crs_description	Project ၏ CRS ဖော်ပြချက်
project_crs_ellipsoid	Project CRS ၏ ဘဲဥပုံစက်ဝိုင်း (ellipsoid)
project_crs_proj4	Project ၏ CRS ၏ proj4 ကိုယ်စားပြုမှု
project_crs_wkt	Project ၏ CRS ၏ WKT (လူသိများသော စာသား) ကိုယ်စားပြုမှု
project_distance_units	လက်ရှိ project အတွက် အကွာအဝေးယူနစ်သည် ဂျီသြမေတြီအလျားနှင့် အကွာအဝေးများကို တွက်ချက်ရာတွင် အသုံးပြုသည်။
project_ellipsoid	Geodetic ဧရိယာများ သို့မဟုတ် ဂျီသြမေတြီများ၏ အလျားများကို တွက်ချက်ရာတွင် အသုံးပြုသည့် လက်ရှိ project ၏ ဘဲဥပုံစက်ဝိုင်း (ellipsoid) အမည်
project_filename	လက်ရှိ project ၏ file အမည်
project_folder	လက်ရှိ project ၏ folder
project_home	လက်ရှိ project ၏ မူရင်းလမ်းကြောင်း
project_identifier	Project သတ်မှတ်သူ (identifier)ကို project metadata မှ ရယူပါသည်။
project_keywords	Project အဓိက စကားလုံး (keywords)များကို project metadata မှ ရယူပါသည်။
project_last_saved	Project ကို နောက်ဆုံးသိမ်းဆည်းသည့် ရက်စွဲ/အချိန်
project_path	လက်ရှိ project ၏ လမ်းကြောင်း အပြည့်အစုံ (file အမည် အပါအဝင်)
project_title	လက်ရှိ project ၏ ခေါင်းစဥ်
project_units	Project CRS ၏ ယူနစ်များ
qgis_locale	QGIS ၏ လက်ရှိ ဘာသာစကား
qgis_os_name	လက်ရှိ OS ၏ အမည်၊ ဥပမာ- ‘windows’၊ ‘linux’ သို့မဟုတ် ‘osx’
qgis_platform	QGIS ပလပ်ဖောင်း ၊ ဥပမာ- ‘desktop’ သို့မဟုတ် ‘server’
qgis_release_name	လက်ရှိ QGIS version ထုတ်ထားသည့် အမည်
qgis_short_version	လက်ရှိ QGIS version အတိုကောက် စာသား
qgis_version	လက်ရှိ QGIS version စာသား
qgis_version_no	လက်ရှိ QGIS version နံပါတ်
row_number	လက်ရှိ row ၏ နံပါတ်ကို သိမ်းဆည်းသည်
snapping_results	Feature တစ်ခုကို digitize (ဂျီသြမေတြီများ ရေးဆွဲခြင်း) ပြုလုပ်နေစဥ်အတွင်း snapping ရလာဒ်များကို ဝင်ရောက်ခွင့်ပေးသည် (feature ပေါင်းထည့်ခြင်းတွင်သာ ရရှိနိုင်သည်)။
scale_value	လက်ရှိ စကေးဘား အကွာအဝေးတန်ဖိုး
selected_file_path	ပြင်ပသိုလှောင်မှုစနစ်ဖြင့် file တစ်ခုကို upload (ထည့်သွင်း) လုပ်သည့်အခါ file widget ရွေးချယ်သည့်အရာမှ ရွေးချယ်ထားသော file လမ်းကြောင်း
symbol_angle	Feature ကို ပုံဖော်ပြသရန် အသုံးပြုသည့် သင်္ကေတ၏ထောင့် (အမှတ်အသား (marker) သင်္ကေတများအတွက်သာ ကိုက်ညီသည်)။
symbol_color	Feature ကို ပုံဖော်ပြသရန် အသုံးပြုသည့် သင်္ကေတ၏ အရောင်
symbol_count	သင်္ကေတဖြင့် ကိုယ်စားပြုသည့် feature များ အရေအတွက် (Layout legend ထဲတွင်)
symbol_id	သင်္ကေတ၏ အတွင်း ID (Layout legend ထဲတွင်)
symbol_label	သင်္ကေတအတွက် အညွှန်း (label) (အသုံးပြုသူသတ်မှတ်ထားသော အညွှန်း သို့မဟုတ် default အားဖြင့် အလိုအလျောက်ထုတ်လုပ်ထားသော အညွှန်း - Layout legend ထဲတွင်)
symbol_layer_count	သင်္ကေတရှိ သင်္ကေတ layer များ စုစုပေါင်းအရေအတွက်
symbol_layer_index	လက်ရှိ သင်္ကေတ layer အညွှန်းကိန်း
symbol_marker_column	အမှတ်အသား (marker) အတွက် Column နံပါတ် (point pattern အဖြည့်များအတွက်သာ ကိုက်ညီသည်)
symbol_marker_row	အမှတ်အသား (marker) အတွက် Row နံပါတ် (point pattern အဖြည့်များအတွက်သာ ကိုက်ညီသည်)
user_account_name	လက်ရှိ အသုံးပြုသူ၏ OS account အမည်
user_full_name	လက်ရှိ အသုံးပြုသူ၏ OS အသုံးပြုသူ အမည်
value	လက်ရှိ တန်ဖိုး
vector_tile_zoom	ပုံဖော်ပြသထားသော မြေပုံ၏ vector tile zoom level အတိအကျ (လက်ရှိ မြေပုံစကေးမှ ရယူပါသည်)။ ပုံမှန်အားဖြင့် [0၊ 20] ကြားရှိသည်။ @zoom_level နှင့်မတူဘဲ၊ ဤ variable သည် interger zoom level နှစ်ခုကြားရှိ တန်ဖိုးများကို interpolate ပြုလုပ်ရန် အသုံးပြုနိုင်သည့် floating point တန်ဖိုးတစ်ခုဖြစ်သည်။
with_variable	Expression တစ်ခုအတွင်း အသုံးပြုမှုအတွက် variable တစ်ခုကို သတ်မှတ်ခွင့်ပြုပြီး တူညီသောတန်ဖိုးကို ထပ်ခါထပ်ခါ ပြန်လည်တွက်ချက်ခြင်းမှ ရှောင်ရှားနိုင်သည်။
zoom_level	ပုံဖော်ပြသထားသော မြေပုံ၏ vector tile zoom level (လက်ရှိ မြေပုံစကေးမှ ရယူပါသည်)။ ပုံမှန်အားဖြင့် [0၊ 20] ကြားရှိသည်။

အချို့ ဥပမာများ-

• Layout ရှိ မြေပုံ item ဗဟိုတစ်ခု၏ X ကိုသြဒိနိတ်ကို ပြန်ထုတ်ပေးပါသည်-:

  x( map_get( item_variables( 'map1'), 'map_extent_center' ) )
  

• လက်ရှိ layer ရှိ feature တစ်ခုချင်းစီအတွက် ထပ်နေသည့် လေဆိပ် feature များ၏ အရေအတွက် ပြန်ထုတ်ပေးပါသည်-:

  aggregate( layer:='airport', aggregate:='count', expression:="code",
                 filter:=intersects( $geometry, geometry( @parent ) ) )
  

• Line တစ်ခု၏ ပထမဆုံး snap လုပ်ထားသည့် point ၏ object_id ကို ရယူပေးပါသည်-:

  with_variable(
    'first_snapped_point',
    array_first( @snapping_results ),
    attribute(
      get_feature_by_id(
        map_get( @first_snapped_point, 'layer' ),
        map_get( @first_snapped_point, 'feature_id' )
      ),
      'object_id'
    )
  )
  

13.2.28. လတ်တလောအသုံးပြုထားသော Function များ (Recent Functions)

ဤအုပ်စုတွင် မကြာသေးမီက အသုံးပြုထားသော function များ ပါဝင်ပါသည်။ အသုံးပြုမှု၏အကြောင်းအရာပေါ်မူတည်၍ (feature ရွေးချယ်ခြင်း၊ field calculator၊ generic) မကြာသေးမီက အသုံးပြုထားသော expression များကို နောက်ဆုံးအဖြစ်ဆုံး မှ အစောဆုံး (more to less recent) သို့ စီထားပြီး သက်ဆိုင်ရာစာရင်းတွင် (expression ၁၀ ခုအထိ) ပေါင်းထည့်ထားသည်။ ၎င်းသည် ယခင်ကအသုံးပြုထားသော expression များကို လျင်မြန်စွာ ပြန်လည်ရယူပြီး ပြန်လည်အသုံးပြုနိုင်စေပါသည်။