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