Remarks

///会被编译， //不会 所以使用///会减慢编译的速度（但不会影响执行速度） ///会在其它的人调用你的代码时提供智能感知 也是一种注释，但是这种注释主要有两种作用： 1.这些注释能够生成一个XML文件。这样呢,看起来会对程序的内容一目了然。 2.以这种方式对你的类，属性，方法等等加上注释之后，当你在其他地方使用以这种方式加上的类，属性，方法等等地时候，黄色的提示框里面会把你写的注释显示出来，是你更加明白你要使用的功能的作用。 /// <summary> ///定义用户姓名属性，该属性为可读可写属性 /// </summary> C# Coding的时候，常常涉及代码注释，常见的注释包括两类： 1）单行注释。格式：// Comments 2）多行注释。格式：/* Comments... */ C#引入了新的XML注释，即我们在某个函数前新起一行，输入///，VS.Net会自动增加XML格式的注释，这里整理一下可用的XML注释。 XML注释分为一级注释（Primary Tags）和二级注释（Secondary Tags），前者可以单独存在，后者必须包含在一级注释内部。 I 一级注释 1. <remarks>对类型进行描述，功能类似<summary>，据说建议使用<remarks>; 2. <summary>对共有类型的类、方法、属性或字段进行注释； 3. <value

GEE2020 由于疫情影响，2020GEE官方峰会（Geo for Good Summit）采取线上举行的方式，所有人可以免费开放申请。会议时间:10月20-21日。申请截止日期9月25日。想参会的老师同学，抓紧时间申请。 NO.壹 Event Details What will happen at the Geo for Good Summit this year? · Tune into the Opening remarks & Keynotes to hear what’s on our minds this year. · Learn about the latest updates to Google Earth Engine, Google Earth and more during Product Demos and Announcements. · Listen to others in the Geo for Good community talk about using mapping technology for social and environmental impact during the Lightning Talks. · Tune into the sessions and ask questions! Before the summit,

反射指程序可以访问、检测和修改它本身状态或行为的一种能力。 程序集包含模块，而模块包含类型，类型又包含成员。反射则提供了封装程序集、模块和类型的对象。 您可以使用反射动态地创建类型的实例，将类型绑定到现有对象，或从现有对象中获取类型。然后，可以调用类型的方法或访问其字段和属性。 反射（Reflection）的优缺点 优点： 1、反射提高了程序的灵活性和扩展性。 2、降低耦合性，提高自适应能力。 3、它允许程序创建和控制任何类的对象，无需提前硬编码目标类。 缺点： 1、性能问题：使用反射基本上是一种解释操作，用于字段和方法接入时要远慢于直接代码。因此反射机制主要应用在对灵活性和拓展性要求很高的系统框架上，普通程序不建议使用。 2、使用反射会模糊程序内部逻辑；程序员希望在源代码中看到程序的逻辑，反射却绕过了源代码的技术，因而会带来维护的问题，反射代码比相应的直接代码更复杂。 用途 反射（Reflection）有下列用途： 它允许在运行时查看属性（attribute）信息。 它允许审查集合中的各种类型，以及实例化这些类型。 它允许延迟绑定的方法和属性（property）。 它允许在运行时创建新类型，然后使用这些类型执行一些任务。 查看元数据 我们已经在上面的章节中提到过，使用反射（Reflection）可以查看属性（attribute）信息。 System.Reflection 类的

最好的总会在不经意间出现。 “ 作为后端程序员，免不了与前端同事对接API， 一个书写良好的API设计文档可有效提高与前端对接的效率。 为避免联调时来回撕逼，今天我们聊一聊正确编写Swaager API文档的姿势。 基础Swagger用法 在 ConfigureServices 配置Swagger文档,在 Configure 启用中间件 // Install-Package Swashbuckle.AspNetCore 略 services.AddSwaggerGen( options => { options.SwaggerDoc("v1", new OpenApiInfo { Title = "EAP API", Version = "v1" }); } ); --- app.UseSwagger(); app.UseSwaggerUI(options => { options.SwaggerEndpoint("/swagger/v1/swagger.json", "EAP API"); }); 应用会在 /Swagger 页面加载最基础的API文档。 以一个最简单的Post请求为例， 细数这最基础Swagger文档的弊病 ： [HttpPost] public async Task<bool> AddHotmapAsync([FromBody]

【PS：原文手打，转载说明出处， 博客园 】 关于为什么用Swagger 　　目前稍微有点规模的公司，已经从原先的瀑布流开发到了敏捷开发，实现前后端分离，为此后端工程师只关注写好Api即可，那程序员最讨厌的就是写Api文档了，故而产生了Swagger。 Swagger原理 　　Swagger就是利用反射技术遍历所有Api接口，并且从xml文件中读取注释，在利用Swagger内置的模板组合html显示至客户端实现接口可视化，并且可调用。 Asp.net WebApi Swagger集成 　　1：vs2017，新建web项目，选择WebApi 　　2：删除Views、Scripts、Models、fonts、Content、Areas目录 　　3：删除RouteConfig.cs、FilterConfig.cs、BundleConfig.cs 　　4：删除HomeController.cs 　　5：Global.asax中删除异常代码 　　6：nuget搜索Swagger,安装 Swashbuckle 　　7：右键项目——》属性——》生成——》输出——》勾选XML文档文件——》保存 　　8：修改SwaggerConfig.cs 　　　　新增方法，释放c.IncludeXmlComments(GetXmlCommentsPath());的注释（注意：例如返回值为对象，然后又不在同一个项目

项目目前已经进入正轨，将在每周更新一次状态，目前是第8次更新，欢迎大家持续关注项目进展！ 项目名称：openFoamUserManual 协作翻译 （已获Gerhard Holzinger博士授权） 项目地址：https://gitee.com/poplee/openFoamUserManual （点击原文链接可进入项目） 项目贡献者（目前有11位，本周没有新增）： poplee Commits: 141 bjorn Commits: 29 zb Commits: 10 fanswords Commits: 9 skf0558 Commits: 6 chuanfeng Commits: 4 邵姝婧 Commits: 3 zhilong Commits: 2 luofq Commits: 2 涂涂 Commits: 1 长安 Commits: 1 小莫 Commits: 1 翻译章节认领情况（红色为本周新增）： 1. Getting help----poplee 2. Lessons learned----poplee 3. Install OpenFOAM----bjorn 4. Updating the repository release of OpenFOAM----poplee 5. Updating OpenFOAM-6 source installation---

项目目前已经进入正轨，将在每周更新一次状态，目前是第12次更新，欢迎大家持续关注项目进展！ 项目名称：openFoamUserManual 协作翻译 （已获Gerhard Holzinger博士授权） 项目地址：https://gitee.com/poplee/openFoamUserManual （点击原文链接可进入项目） 项目贡献者（目前有12位，本周无新增）： poplee Commits: 149 bjorn Commits: 29 zb Commits: 10 fanswords Commits: 9 skf0558 Commits: 6 chuanfeng Commits: 4 邵姝婧 Commits: 4 zhilong Commits: 2 luofq Commits: 2 涂涂 Commits: 1 长安 Commits: 1 小莫 Commits: 1 翻译章节认领情况（新增为红色）： 1. Getting help----poplee 2. Lessons learned----poplee 3. Install OpenFOAM----bjorn 4. Updating the repository release of OpenFOAM----poplee 5. Updating OpenFOAM-6 source installation---

项目目前已经进入正轨，将在每周更新一次状态，目前是第10次更新，欢迎大家持续关注项目进展！ 项目名称：openFoamUserManual 协作翻译 （已获Gerhard Holzinger博士授权） 项目地址：https://gitee.com/poplee/openFoamUserManual （点击原文链接可进入项目） 项目贡献者（目前有11位，标红为本周新增）： poplee Commits: 144 bjorn Commits: 29 zb Commits: 10 fanswords Commits: 9 skf0558 Commits: 6 chuanfeng Commits: 4 邵姝婧 Commits: 4 zhilong Commits: 2 luofq Commits: 2 涂涂 Commits: 1 长安 Commits: 1 小莫 Commits: 1 翻译章节认领情况（本周无新增）： 1. Getting help----poplee 2. Lessons learned----poplee 3. Install OpenFOAM----bjorn 4. Updating the repository release of OpenFOAM----poplee 5. Updating OpenFOAM-6 source installation---

项目目前已经进入正轨，将在每周更新一次状态，目前是第7次更新，欢迎大家持续关注项目进展！ 项目名称：openFoamUserManual 协作翻译 （已获Gerhard Holzinger博士授权） 项目地址：https://gitee.com/poplee/openFoamUserManual （点击原文链接可进入项目） 项目贡献者（目前有11位，标红为本周新增）： poplee Commits: 130 bjorn Commits: 29 fanswords Commits: 9 skf0558 Commits: 6 chuanfeng Commits: 4 邵姝婧 Commits: 3 zhilong Commits: 2 luofq Commits: 2 涂涂 Commits: 1 zb Commits: 1 长安 Commits: 1 小莫 Commits: 1 翻译章节认领情况（红色为本周新增）： 1. Getting help----poplee 2. Lessons learned----poplee 3. Install OpenFOAM----bjorn 4. Updating the repository release of OpenFOAM----poplee 5. Updating OpenFOAM-6 source installation---

等离子体元分析用于同时测定斯托克斯参数 摘要： 测量光的偏振态是一个固有的难题，因为正交偏振态之间的相位信息在检测过程中往往会丢失。 在本文中，我们提出了在适当设计的相位梯度双折射元表面上，归一化斯托克斯参数与衍射对比的等价性，并引入了全极化双折射元的概念。 元网格由三个交织的元表面组成，通过同时进行(即 (平行)相应衍射强度的测量，可以立即揭示被测偏振态的斯托克斯参数。 基于800 nm波长反射的等离子体元表面，我们设计并实现了相梯度双折射元表面和相应的元配准，而所制备组件的实验表征令人信服地展示了预期的功能。 我们预见在任何感兴趣的频率范围内，在紧凑的偏振设置中使用元agrating. 1. 介绍 测量光的偏振态是一个固有的难题，因为正交偏振态之间的相位信息在检测过程中往往会丢失。因此，确定偏振通常需要一系列测量， 在探测器前连续放置适当排列的偏振器 ，从而最终获得与椭圆偏振参数类似的 斯托克斯参数 ，充分描述偏振状态。 作为一种一次性测量偏振状态的方法，通过将入射光束分成几束，并使用多个偏振镜和探测器，可以使测量过程并行化，（虽然这种方法增加了光学系统的尺寸和复杂性）。 尽管在确定偏振方面存在诸多不便，但在大多数应用中，知道这个参数是至关重要的，因为光与物质的相互作用通常依赖于偏振。作为典型的例子，我们提到了平面波在材料界面的反射和传输，在这些界面中，正交极化的菲涅耳系数不同