Modul:Timing/doc

Ushbu modulning maqsadi Lua-funksiyalarning ishlashini sozlash uchun vaqt tahlilini oʻtkazishning oddiy usulini taqdim etish, yaʼni funktsiyalarni profillash. Odatda funktsiya chaqiruvlarining davomiyligini oʻlchash qiyinchiliklar va muammoli kodlarni aniqlash boʻyicha katta saʼy-harakatlarning bir qismidir. Bu toʻliq profillovchi emas, chunki joriy oʻrnatishda chiziqni kuzatish (chaqiruv grafik profilini yaratish) mumkin emas. Uning yagona maqsadi — bajarilish vaqtini oʻlchash (tekis profil yaratish) va buni konsolidan (yaʼni, bitta funksiyada) interaktiv qilishdir.

Ushbu matnda bir necha bor aytilganidek; vaqt aniq emas va u faqat funksiyaning taxminiy ish vaqti va yukining qoʻpol oʻlchovi sifatida ishlatilishi kerak. Modul uchun ruxsat etilgan maksimal vaqt oraligʻiga moslashish uchun modulni sozlashga urinmang, chegaradan ancha pastroq turing!

Vaqt tahlili bajariladigan funksiya bilan chaqiriladi va ixtiyoriy ravishda har bir test toʻplamining soni (hajmi, standart 100) va shunga oʻxshash test toʻplamlarining soni (standart 10). Qoʻngʻiroqlarning umumiy soni × toʻplamlar soni boʻladi va funksiya uchun oʻrtacha ish vaqtini beradi. Standart ogʻish toʻplamlar sonidan hisoblanadi va faqat qoʻpol taxmin boʻladi. Agar faqat bitta toʻplam bilan ishlasangiz, standart ogʻish yoʻqoladi, lekin u oʻlchanmasa ham, bajarish vaqti oʻzgaradi.

Profiler jami qoʻngʻiroqlar boʻylab ikkita oʻtishni amalga oshiradi, biri qoʻgʻirchoq va ikkinchisi haqiqiy funktsiyaga ega. Bu qoʻshimcha kod qanchalik ogʻirligi haqida asosiy maʼlumotni olish imkonini beradi va keyin biz buni sinab koʻrayotgan funktsiya oʻlchovidan ayirishimiz mumkin. Agar tekshirilayotgan funktsiya sodda boʻlsa, bajarilish vaqtlari yaqin boʻladi va farqdagi noaniqlik yuqori boʻlishi mumkin. Agar bajarilish vaqti standart ogʻish bilan oʻxshash boʻlsa, tahlilni kattaroq yoki koʻproq toʻplamlar bilan qayta bajarish kerak.

Rivojlanish jarayonida maʼlum boʻldiki, 10 ta toʻplamda 100 ta qoʻngʻiroq odatda yaxshi baho olish uchun etarli, ammo bu raqamlarga ortiqcha vazn qoʻymaslik kerak. Agar bitta funktsiya ikki marta yoki daraxt vaqtlari yoki hatto oʻn barobar sekinroq boʻlsa, u doimiy yoki chiziqli vaqt ichida ishlayotgan ekan, bunga qarshi boʻlmang. Agar biror narsa 100 baravar sekinroq boʻlsa yoki uning eksponensial vaqtda ishlashini koʻrsatsa, unda boshqa algoritmlarni koʻrib chiqish kerak.

Foydalanish

Ushbu modul oddiy shablonlarda yoki sahifalarda foydalanish uchun emas, u modul sahifalarida tahrirlash oynasi ostidagi konsolida ishlatilishi kerak. Sinov muhitida moduldan foydalanish uchun pastga qarang. Oddiy funktsiyani sinab koʻrish

Masalan, Module:Example sahifasini ochamiz, deb faraz qilamiz, keyin p.hello() funksiyasini profillash uchun chaqiruv yozishimiz mumkin. Sahifadagi kod quyidagi misolga oʻxshaydi, ammo mahalliy versiyalar biroz boshqacha boʻlishi mumkin. (Hozirgi vaqtda shunga oʻxshash kod w:no:Module:HelloWorld2 da mavjud.)

Quyidagi kod Module:Examplening qisqartirilgan versiyasidir. Toʻliq versiya uchun sahifaga qarang.

local p = {};

p.hello = function(frame)
    local str = "Hello World!"
    return str
end

return p

Ushbu kodga kirish konsolidagi umumiy p orqali amalga oshiriladi. Oldingi kodni hisobga olsak, profilerni shunday deb atash mumkin.

=require 'Module:Timingʻ(p.hello)

Shunga oʻxshash bir xil turdagi modul uchun enwiki-da quyidagi kabi hisobotni yaratdi.

=require 'Module:Timing'(p.hello)
Each call was running for about 1.2e-09 seconds.
	Mean runtime for each set was 1.2e-07 seconds,
	with standard deviation of 1.9e-06 seconds,
	minimum 8.9e-06, maximum 1.5e-05.
	Total time spent was about 2.5e-04 seconds.
Relative load is estimated to 1.0.

Bunda muhim maʼlumot har biri taxminan 8,5120000000022E-9 soniya davom etgan. Bu funksiya aslida qancha vaqt ishlashini bildiradi.

Eʼtibor bering, bu funktsiya juda oddiy va shuning uchun funktsiyaning ishlash vaqti asosiy ish vaqtiga yaqinlashadi. Natijada, har bir toʻplam uchun ishlash vaqti standart ogʻishlarga yaqinlashadi.