[{"data":1,"prerenderedAt":554},["ShallowReactive",2],{"page-\u002Futils\u002Fapi\u002Ffunctions\u002FbuildLoggerReadings":3,"navigation":167},{"collection":4,"page":5},"docs_en",{"id":6,"title":7,"body":8,"description":35,"extension":158,"meta":159,"navigation":161,"path":162,"rawbody":163,"seo":164,"stem":165,"__hash__":166},"docs_en\u002Futils\u002Fapi\u002Ffunctions\u002FbuildLoggerReadings.md","buildLoggerReadings",{"type":9,"value":10,"toc":145},"minimark",[11,33,36,65,70,73,82,90,92,100,103,107,111,117,120,132,135],[12,13,14],"blockquote",{},[15,16,17,20,21,25,26,29,30],"p",{},[18,19,7],"strong",{},"(",[22,23,24],"code",{},"rows",", ",[22,27,28],{},"mapping","): ",[22,31,32],{},"object",[15,34,35],{},"Turns imported rows into logger readings using a column mapping.",[15,37,38,39,42,43,46,47,52,53,56,57,60,61,64],{},"The first ",[22,40,41],{},"headerRows"," rows are skipped. Timestamps that carry an offset keep\nit; otherwise ",[22,44,45],{},"timeZone"," (resolved with ",[48,49,51],"a",{"href":50},"\u002Futils\u002Fapi\u002Ffunctions\u002FlocalDateTimeToInstant","localDateTimeToInstant",") and\nthen ",[22,54,55],{},"offset"," apply, in that order. Decimal commas are accepted. With\n",[22,58,59],{},"valueKind: 'water_column'"," the depth is ",[22,62,63],{},"sensorDepth − value",", rounded to 3\ndecimals. A date without a time reads as 00:00.",[66,67,69],"h2",{"id":68},"parameters","Parameters",[71,72,24],"h3",{"id":24},[15,74,75,78,79],{},[22,76,77],{},"string","[]",[80,81],"span",{},[15,83,84,85,89],{},"Rows from ",[48,86,88],{"href":87},"\u002Futils\u002Fapi\u002Ffunctions\u002FparseDelimitedText","parseDelimitedText",".",[71,91,28],{"id":28},[15,93,94],{},[48,95,97],{"href":96},"\u002Futils\u002Fapi\u002Ftype-aliases\u002FLoggerImportMapping",[22,98,99],{},"LoggerImportMapping",[15,101,102],{},"Column mapping and conventions.",[66,104,106],{"id":105},"returns","Returns",[15,108,109],{},[22,110,32],{},[15,112,113,114,116],{},"The readings and the skipped rows with their zero-based index in\n",[22,115,24],{}," (header rows included) and the reason.",[71,118,119],{"id":119},"readings",[12,121,122],{},[15,123,124,126,127,130],{},[18,125,119],{},": ",[22,128,129],{},"LoggerReading",[80,131],{},[71,133,134],{"id":134},"skipped",[12,136,137],{},[15,138,139,126,141,143],{},[18,140,134],{},[22,142,32],{},[80,144],{},{"title":146,"searchDepth":147,"depth":147,"links":148},"",2,[149,154],{"id":68,"depth":147,"text":69,"children":150},[151,153],{"id":24,"depth":152,"text":24},3,{"id":28,"depth":152,"text":28},{"id":105,"depth":147,"text":106,"children":155},[156,157],{"id":119,"depth":152,"text":119},{"id":134,"depth":152,"text":134},"md",{"generated":160},true,false,"\u002Futils\u002Fapi\u002Ffunctions\u002FbuildLoggerReadings","---\npath: \"\u002Futils\u002Fapi\u002Ffunctions\u002FbuildLoggerReadings\"\ntitle: buildLoggerReadings\ndescription: \"Turns imported rows into logger readings using a column mapping.\"\ngenerated: true\nnavigation: false\n---\n\n> **buildLoggerReadings**(`rows`, `mapping`): `object`\n\nTurns imported rows into logger readings using a column mapping.\n\nThe first `headerRows` rows are skipped. Timestamps that carry an offset keep\nit; otherwise `timeZone` (resolved with [localDateTimeToInstant](\u002Futils\u002Fapi\u002Ffunctions\u002FlocalDateTimeToInstant)) and\nthen `offset` apply, in that order. Decimal commas are accepted. With\n`valueKind: 'water_column'` the depth is `sensorDepth − value`, rounded to 3\ndecimals. A date without a time reads as 00:00.\n\n## Parameters\n\n### rows\n\n`string`[][]\n\nRows from [parseDelimitedText](\u002Futils\u002Fapi\u002Ffunctions\u002FparseDelimitedText).\n\n### mapping\n\n[`LoggerImportMapping`](\u002Futils\u002Fapi\u002Ftype-aliases\u002FLoggerImportMapping)\n\nColumn mapping and conventions.\n\n## Returns\n\n`object`\n\nThe readings and the skipped rows with their zero-based index in\n  `rows` (header rows included) and the reason.\n\n### readings\n\n> **readings**: `LoggerReading`[]\n\n### skipped\n\n> **skipped**: `object`[]\n",{"title":7,"description":35},"utils\u002Fapi\u002Ffunctions\u002FbuildLoggerReadings","piw5Q-N54XPpZzjblo2UCHk6fY0tJDOt7srH_0bqzaE",{"docs_en":168,"spec":485,"changelogs":535},[169,189,208,263,373,427],{"title":170,"path":171,"stem":172,"children":173},"Ai","\u002Fai","ai",[174,177,181,185],{"title":175,"path":171,"stem":176},"Introduction","ai\u002Findex",{"title":178,"path":179,"stem":180},"Converting reports with an assistant","\u002Fai\u002Fconversion-skill","ai\u002Fconversion-skill",{"title":182,"path":183,"stem":184},"llms.txt and Markdown pages","\u002Fai\u002Fllms","ai\u002Fllms",{"title":186,"path":187,"stem":188},"MCP server","\u002Fai\u002Fmcp","ai\u002Fmcp",{"title":190,"path":191,"stem":192,"children":193},"Contributing","\u002Fcontributing","contributing",[194,196,200,204],{"title":175,"path":191,"stem":195},"contributing\u002Findex",{"title":197,"path":198,"stem":199},"Writing docs","\u002Fcontributing\u002Fwriting-docs","contributing\u002F1.writing-docs",{"title":201,"path":202,"stem":203},"Update rules","\u002Fcontributing\u002Fupdate-rules","contributing\u002F2.update-rules",{"title":205,"path":206,"stem":207},"Content components","\u002Fcontributing\u002Fcomponents","contributing\u002Fcomponents",{"title":209,"path":210,"stem":211,"children":212},"Core","\u002Fcore","core",[213,215,228,257],{"title":175,"path":210,"stem":214},"core\u002Findex",{"title":216,"path":217,"stem":218,"children":219,"page":161},"Getting Started","\u002Fcore\u002Fgetting-started","core\u002F1.getting-started",[220,224],{"title":221,"path":222,"stem":223},"Installation","\u002Fcore\u002Fgetting-started\u002Finstallation","core\u002F1.getting-started\u002F1.installation",{"title":225,"path":226,"stem":227},"First use","\u002Fcore\u002Fgetting-started\u002Ffirst-use","core\u002F1.getting-started\u002F2.first-use",{"title":229,"path":230,"stem":231,"children":232,"page":161},"Guides","\u002Fcore\u002Fguides","core\u002F2.guides",[233,237,241,245,249,253],{"title":234,"path":235,"stem":236},"Parsing and validating","\u002Fcore\u002Fguides\u002Fparsing-and-validating","core\u002F2.guides\u002F1.parsing-and-validating",{"title":238,"path":239,"stem":240},"Serializing and sharing","\u002Fcore\u002Fguides\u002Fserializing-and-sharing","core\u002F2.guides\u002F2.serializing-and-sharing",{"title":242,"path":243,"stem":244},"Unit conversion","\u002Fcore\u002Fguides\u002Funit-conversion","core\u002F2.guides\u002F3.unit-conversion",{"title":246,"path":247,"stem":248},"Vocabularies and textures","\u002Fcore\u002Fguides\u002Fvocabularies-and-textures","core\u002F2.guides\u002F4.vocabularies-and-textures",{"title":250,"path":251,"stem":252},"Water quality vocabulary","\u002Fcore\u002Fguides\u002Fwater-quality-vocabulary","core\u002F2.guides\u002F5.water-quality-vocabulary",{"title":254,"path":255,"stem":256},"Versions and time zones","\u002Fcore\u002Fguides\u002Fversions-and-time-zones","core\u002F2.guides\u002F6.versions-and-time-zones",{"title":258,"path":259,"stem":260,"children":261},"API reference","\u002Fcore\u002Fapi","core\u002Fapi\u002Findex",[262],{"title":258,"path":259,"stem":260},{"title":264,"path":265,"stem":266,"children":267},"Format","\u002Fformat","format",[268,270,290,319,343,363,369],{"title":175,"path":265,"stem":269},"format\u002Findex",{"title":216,"path":271,"stem":272,"children":273,"page":161},"\u002Fformat\u002Fgetting-started","format\u002F1.getting-started",[274,278,282,286],{"title":275,"path":276,"stem":277},"What is .well?","\u002Fformat\u002Fgetting-started\u002Fwhat-is-well","format\u002F1.getting-started\u002F1.what-is-well",{"title":279,"path":280,"stem":281},"For geologists","\u002Fformat\u002Fgetting-started\u002Ffor-geologists","format\u002F1.getting-started\u002F2.for-geologists",{"title":283,"path":284,"stem":285},"For developers","\u002Fformat\u002Fgetting-started\u002Ffor-developers","format\u002F1.getting-started\u002F3.for-developers",{"title":287,"path":288,"stem":289},"Your first .well file","\u002Fformat\u002Fgetting-started\u002Ffirst-well-file","format\u002F1.getting-started\u002F4.first-well-file",{"title":291,"path":292,"stem":293,"children":294,"page":161},"Concepts","\u002Fformat\u002Fconcepts","format\u002F2.concepts",[295,299,303,307,311,315],{"title":296,"path":297,"stem":298},"Depths and intervals","\u002Fformat\u002Fconcepts\u002Fdepths-and-intervals","format\u002F2.concepts\u002F1.depths-and-intervals",{"title":300,"path":301,"stem":302},"Units and precision","\u002Fformat\u002Fconcepts\u002Funits-and-precision","format\u002F2.concepts\u002F2.units-and-precision",{"title":304,"path":305,"stem":306},"Vocabularies","\u002Fformat\u002Fconcepts\u002Fvocabularies","format\u002F2.concepts\u002F3.vocabularies",{"title":308,"path":309,"stem":310},"Profiles","\u002Fformat\u002Fconcepts\u002Fprofiles","format\u002F2.concepts\u002F4.profiles",{"title":312,"path":313,"stem":314},"Versions and deprecation","\u002Fformat\u002Fconcepts\u002Fversions-and-deprecation","format\u002F2.concepts\u002F5.versions-and-deprecation",{"title":316,"path":317,"stem":318},"Extensibility","\u002Fformat\u002Fconcepts\u002Fextensibility","format\u002F2.concepts\u002F6.extensibility",{"title":229,"path":320,"stem":321,"children":322,"page":161},"\u002Fformat\u002Fguides","format\u002F3.guides",[323,327,331,335,339],{"title":324,"path":325,"stem":326},"Writing a .well by hand","\u002Fformat\u002Fguides\u002Fwriting-by-hand","format\u002F3.guides\u002F1.writing-by-hand",{"title":328,"path":329,"stem":330},"Converting a report","\u002Fformat\u002Fguides\u002Fconverting-a-report","format\u002F3.guides\u002F2.converting-a-report",{"title":332,"path":333,"stem":334},"Validating","\u002Fformat\u002Fguides\u002Fvalidating","format\u002F3.guides\u002F3.validating",{"title":336,"path":337,"stem":338},"Extending for your own needs","\u002Fformat\u002Fguides\u002Fextending","format\u002F3.guides\u002F4.extending",{"title":340,"path":341,"stem":342},"Building an editor or database on .well","\u002Fformat\u002Fguides\u002Fbuilding-on-well","format\u002F3.guides\u002F5.building-on-well",{"title":344,"path":345,"stem":346,"children":347},"Overview","\u002Fformat\u002Freference","format\u002F4.reference\u002Findex",[348,349,353,357],{"title":344,"path":345,"stem":346},{"title":350,"path":351,"stem":352},"JSON Schema","\u002Fformat\u002Freference\u002Fjson-schema","format\u002F4.reference\u002F1.json-schema",{"title":354,"path":355,"stem":356},"Example wells","\u002Fformat\u002Freference\u002Fexamples","format\u002F4.reference\u002F2.examples",{"title":358,"path":359,"stem":360,"children":361},"Object reference","\u002Fformat\u002Freference\u002Fobjects","format\u002Freference\u002Fobjects\u002Findex",[362],{"title":358,"path":359,"stem":360},{"title":364,"path":365,"stem":366,"children":367},"About the spec","\u002Fformat\u002Fspec","format\u002F5.spec\u002Findex",[368],{"title":364,"path":365,"stem":366},{"title":370,"path":371,"stem":372},"Changelog","\u002Fformat\u002Fchangelog","format\u002F6.changelog",{"title":374,"path":375,"stem":376,"children":377},"Render","\u002Frender","render",[378,380,390,422],{"title":175,"path":375,"stem":379},"render\u002Findex",{"title":216,"path":381,"stem":382,"children":383,"page":161},"\u002Frender\u002Fgetting-started","render\u002F1.getting-started",[384,387],{"title":221,"path":385,"stem":386},"\u002Frender\u002Fgetting-started\u002Finstallation","render\u002F1.getting-started\u002F1.installation",{"title":225,"path":388,"stem":389},"\u002Frender\u002Fgetting-started\u002Ffirst-use","render\u002F1.getting-started\u002F2.first-use",{"title":229,"path":391,"stem":392,"children":393,"page":161},"\u002Frender\u002Fguides","render\u002F2.guides",[394,398,402,406,410,414,418],{"title":395,"path":396,"stem":397},"Panels and layout","\u002Frender\u002Fguides\u002Fpanels-and-layout","render\u002F2.guides\u002F1.panels-and-layout",{"title":399,"path":400,"stem":401},"Layers and labels","\u002Frender\u002Fguides\u002Flayers-and-labels","render\u002F2.guides\u002F2.layers-and-labels",{"title":403,"path":404,"stem":405},"Theming","\u002Frender\u002Fguides\u002Ftheming","render\u002F2.guides\u002F3.theming",{"title":407,"path":408,"stem":409},"Locale and units","\u002Frender\u002Fguides\u002Flocale-and-units","render\u002F2.guides\u002F4.locale-and-units",{"title":411,"path":412,"stem":413},"Legends","\u002Frender\u002Fguides\u002Flegends","render\u002F2.guides\u002F5.legends",{"title":415,"path":416,"stem":417},"Zoom, pan and highlights","\u002Frender\u002Fguides\u002Finteraction","render\u002F2.guides\u002F6.interaction",{"title":419,"path":420,"stem":421},"Using it in a framework","\u002Frender\u002Fguides\u002Fframeworks","render\u002F2.guides\u002F7.frameworks",{"title":258,"path":423,"stem":424,"children":425},"\u002Frender\u002Fapi","render\u002Fapi\u002Findex",[426],{"title":258,"path":423,"stem":424},{"title":428,"path":429,"stem":430,"children":431},"Utils","\u002Futils","utils",[432,434,444,480],{"title":175,"path":429,"stem":433},"utils\u002Findex",{"title":216,"path":435,"stem":436,"children":437,"page":161},"\u002Futils\u002Fgetting-started","utils\u002F1.getting-started",[438,441],{"title":221,"path":439,"stem":440},"\u002Futils\u002Fgetting-started\u002Finstallation","utils\u002F1.getting-started\u002F1.installation",{"title":225,"path":442,"stem":443},"\u002Futils\u002Fgetting-started\u002Ffirst-use","utils\u002F1.getting-started\u002F2.first-use",{"title":229,"path":445,"stem":446,"children":447,"page":161},"\u002Futils\u002Fguides","utils\u002F2.guides",[448,452,456,460,464,468,472,476],{"title":449,"path":450,"stem":451},"Geometry and volumes","\u002Futils\u002Fguides\u002Fgeometry-and-volumes","utils\u002F2.guides\u002F1.geometry-and-volumes",{"title":453,"path":454,"stem":455},"Water levels and pumping tests","\u002Futils\u002Fguides\u002Fpumping-tests","utils\u002F2.guides\u002F2.pumping-tests",{"title":457,"path":458,"stem":459},"Permits","\u002Futils\u002Fguides\u002Fpermits","utils\u002F2.guides\u002F3.permits",{"title":461,"path":462,"stem":463},"Operation and production","\u002Futils\u002Fguides\u002Foperation","utils\u002F2.guides\u002F4.operation",{"title":465,"path":466,"stem":467},"Water quality","\u002Futils\u002Fguides\u002Fwater-quality","utils\u002F2.guides\u002F5.water-quality",{"title":469,"path":470,"stem":471},"Logger import","\u002Futils\u002Fguides\u002Flogger-import","utils\u002F2.guides\u002F6.logger-import",{"title":473,"path":474,"stem":475},"SIAGAS import","\u002Futils\u002Fguides\u002Fsiagas-import","utils\u002F2.guides\u002F7.siagas-import",{"title":477,"path":478,"stem":479},"Formatting","\u002Futils\u002Fguides\u002Fformatting","utils\u002F2.guides\u002F8.formatting",{"title":258,"path":481,"stem":482,"children":483},"\u002Futils\u002Fapi","utils\u002Fapi\u002Findex",[484],{"title":258,"path":481,"stem":482},[486],{"title":264,"path":265,"stem":266,"children":487,"page":161},[488],{"title":489,"path":365,"stem":490,"children":491,"page":161},"Spec","format\u002Fspec",[492,501,510],{"title":493,"path":494,"stem":495,"children":496,"page":161},"Reference","\u002Fformat\u002Fspec\u002Freference","format\u002Fspec\u002Freference",[497],{"title":498,"path":499,"stem":500},"FGDC Texture Patterns Reference","\u002Fformat\u002Fspec\u002Freference\u002Ffgdc-textures","format\u002Fspec\u002Freference\u002Ffgdc-textures",{"title":502,"path":503,"stem":504,"children":505,"page":161},"V1","\u002Fformat\u002Fspec\u002Fv1","format\u002Fspec\u002Fv1",[506],{"title":507,"path":508,"stem":509},".well File Format Specification","\u002Fformat\u002Fspec\u002Fv1\u002Fwell-format","format\u002Fspec\u002Fv1\u002Fwell-format",{"title":511,"path":512,"stem":513,"children":514,"page":161},"V2","\u002Fformat\u002Fspec\u002Fv2","format\u002Fspec\u002Fv2",[515,519,523,527,531],{"title":516,"path":517,"stem":518},".well File Format Specification — Version 2.4: Format Reference","\u002Fformat\u002Fspec\u002Fv2\u002Fformat-reference","format\u002Fspec\u002Fv2\u002Fformat-reference",{"title":520,"path":521,"stem":522},".well File Format Specification — Version 2.4: Interoperability","\u002Fformat\u002Fspec\u002Fv2\u002Finteroperability","format\u002Fspec\u002Fv2\u002Finteroperability",{"title":524,"path":525,"stem":526},".well File Format Specification — Version 2.4: Object Schemas","\u002Fformat\u002Fspec\u002Fv2\u002Fobject-schemas","format\u002Fspec\u002Fv2\u002Fobject-schemas",{"title":528,"path":529,"stem":530},".well File Format Specification — Version 2.4: Overview","\u002Fformat\u002Fspec\u002Fv2\u002Foverview","format\u002Fspec\u002Fv2\u002Foverview",{"title":532,"path":533,"stem":534},".well File Format Specification — Version 2.4: Water Quality","\u002Fformat\u002Fspec\u002Fv2\u002Fwater-quality","format\u002Fspec\u002Fv2\u002Fwater-quality",[536,542,548],{"title":209,"path":210,"stem":211,"children":537,"page":161},[538],{"title":539,"path":540,"stem":541},"@welldot\u002Fcore","\u002Fcore\u002Fchangelog","core\u002FCHANGELOG",{"title":374,"path":375,"stem":376,"children":543,"page":161},[544],{"title":545,"path":546,"stem":547},"@welldot\u002Frender","\u002Frender\u002Fchangelog","render\u002FCHANGELOG",{"title":428,"path":429,"stem":430,"children":549,"page":161},[550],{"title":551,"path":552,"stem":553},"@welldot\u002Futils","\u002Futils\u002Fchangelog","utils\u002FCHANGELOG",1793050499120]